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PREFACE 



This manual was formerly called the CYBER Cross Link 
Edit/Library Maintenance Reference Manual. Under its 
new form and title, this manual describes five CYBER 
Cross System build utilities which aid in generating load 
files for a CONTROL DATA 255X Network Processor Unit 
(NPU). Such a load file contains the on-line system for an 
network processing unit. The load files are of two types: 

• A Communications Control Program (CCP) used 
as a part of a NOS Network, 

• A Communications Control INTERCOM (CC1) used 
as a part of a NOS/BE Network. 

These utilities are run on a CYBER host (6000, CYBER 70 
series, or CYBER 170 series) under the NOS or NOS/BE 
operating systems. It is assumed that the reader is 
familiar with the command structure of these operating 
systems. 

The utilities described in this manual are: 

• The library maintenance utility (MPLIB) used with 
CCI that allows the user to generate a new library 
of object code modules. While this utility could 
be used with CCP, the current installation 
procedures do not use it. 

■ The Expand utility used with CCP that has two 
functions: 



Therefore, to fully use the capabilities of the utilities, the 
reader of this manual should be familiar with the 
following concepts: 

• Installation procedures using a NOS or NOS/BE 
operating system. 



The CYBER Cross 
compiler. 



version of the PASCAL 



The CYBER Cross 
microassemblers. 



macroassemblers and 



CONVENTIONS USED 

Throughout this manual, the following conventions are 
used in the presentation of statement formats, commands 
and request formats, operator type-ins, and diagnostic 
messages: 

ALN Uppercase letters indicate words, acronyms, 
keywords, or mnemonics required by the 
network software as input to it, or produced as 
output. 

aln Lowercase letters identify variables for which 
values are supplied by a console operator, a 
programmer using batch input, or by the system 
itself. 



(1) It allows a user to generate a variant input 
for the application programs and hardware of 
NPU. (See the glossary for the use of the 
term application.) 

(2) It provides variant inputs for the NOS 
load-file generator utility. 

• The Autolink utility used with CCP generates 
input directives for the Link utility. 

• The Link utility (MPLINK) assigns space for 
modules and links modules together. This utility 
produces a memory image load module file that 
can later be converted to a load file. The utility 
is used with both CCP and CCI. 

■ The Edit utility (MPEDIT) allows the user to 
initialize values in the memory image load 
module. The utility is used with both CCP and 
CCI. 

The memory image load module file that is produced for 
an NPU by these utilities is composed of object code 
modules that were initially generated by one of three 
CYBER Cross programs: 

■ The CYBER Cross PASCAL compiler 

• The CYBER Cross macroassembler 

■ The CYBER Cross microassembler 



[ ] 



Ellipses indicate omitted entities that repeat 
the form and function of the last entity given 
(exception: in PASCAL statements, ellipses are 
indicated by ..). 

Square brackets enclose entities that are 
optional. If omission of an entity causes the use 
of a default value, the default is noted. 

Braces enclose entities from which one must be 
chosen. 

An underscore indicates a control character 
(examples: carriage return is CR, line feed is 
LF , and space is SP ). If a space is required in a 
command, it is indicated as SP. Spaces shown 
in a command are normally placed there only 
for convenience in separating the parameters; 
they are not required. 



All numbers are given in decimal notation unless 
otherwise specified. Hexadecimal numbers in text are 
given a subscripted 16, for instance, COOOig. 
Hexadecimal parameters in commands require the display 
code designator, the dollar sign ($), for example, $C000. 



RELATED MANUALS 

Additional information on the CYBER Cross system and 
the CCP and CCI installation procedures can be found in 
the following documents that are available from Control 
Data Corporation, Literature and Distribution Services, 
308 North Dale Street, St. Paul, Minnesota, 55103. 
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INTRODUCTION 



This manual describes five utility programs used to build 
the memory image load module file, and to maintain the 
object code library file for 255X Network Processor Unit 
(NPU) on-line programs. These utilities are normally used 
in conduction with the standard CCP or CCI installation 
procedures described in the NOS and NOS/BE Installation 
Handbooks. The utilities are called and executed 
automatically from those installation procedures. The 
utilities are: 

• A library maintenance program (MPLIB) used only 
with CCI 



AUTOLINK 

Autolink uses a set of input directives to generate 
MPLINK input directives for CCP. Autolink simplifies 
module assignment and maximizes the amount of space 
that is assigned to message processing buffers. 

Autolink also gives information about the amount of 
buffer space that would be available for various 
combinations of application packages (such as combi- 
nations of TIPs) located in an NPU with a given memory 
size. 



• A system variant handler (Expand) used only with 
CCP 

■ An Autolink auxiliary for the Link utility used 
only with CCP 

• A Link utility (MPLINK) used with both CCP and 
CCI 

■ An Editor utility (MPEDIT) used with both CCP 
and CCI 

All the utilities execute on a CYBER host computer 
operating under NOS or NOS/BE. 

Figure 1-1 shows the logical flow of the utilities in 
producing a downline load file for a CCP system. 



LIBRARY MAINTENANCE (MPLIB) 

This utility uses object code from a previous library or 
from one of the CYBER Cross compilers or assemblers to 
generate a new library file. The library consists of object 
code and a directory to all the modules on the libraries. 

SYSTEM VARIANT GENERATOR 
(EXPAND) 

Several hardware and software variables must be specified 
to customize a CCP load file for a given NPU 
configuration in a network. Expand has two parts: a 
variant definition section, and a section that aids the NOS 
load file generator utility in building the CCP load file. 

As shown in figure 1-1, the variant definition section 
operates with a user-supplied file, called USERBPS, to 
generate a temporary new program library and a set of 
updated autolink directives. 

The load file generator section supplies variant definitions 
to the NOS load file generator utility. That utility 
converts the initialized CCP memory image load file 
module produced by the link Editor into a CCP load file 
that can be downline loaded from the host into an NPU. 
As shown in figure 1-1, the initialized load module file is 
one of the inputs used to produce the load file for CCP. 



NOTE 

Application programs are defined for CCP 
and CCI as well as for the host. In this 
manual, an application program (called an 
application) executes in the NPU. (See 
the glossary for the use of the term 
application.) 



LINKING UTILITY (MPLINK) 

MPLINK assigns space, and links together all the modules 
that are to used in a build operation, that is, all the 
modules that are to be a part of the load file. Each 
module is assigned an execution space on a memory image 
load module file, which (after initial values are assigned) 
can be converted to the load file for the NPU. 



EDITOR (MPEDIT) 

After MPLINK generates a memory image load module 
file (ABSOLMP and a symbol table file (SYMTAB)), the 
Editor utility initializes values in selected variables. The 
variables to be initialized; and the initialization values are 
specified by an MPEDIT program which uses a 
PASCAL-Iike syntax. 



INPUTS TO THE UTILITIES 

There are two types of inputs to the utilities: 

• Directive files. These directives are normally 
arranged into a batch input file. 

• Other files. The most important of these files 
consist of object code modules which are built 
into the on-line CCP or CCI system. 

GENERAL COMMAND FORMAT FOR THE UTILITIES 

The command inputs to the utilites are in the form of 
directives. The general form of any directive is a 
command identifier (keyword) followed by a set of 
parameters: 

KEYWORD, param 1, param 2, ..., param n 
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USER BPS 



USER 
PARAMETER 



IDENTIFIES 
VARIANT 



COMBINED 
PROGRAM 
LIBRARY 



CONTAINS SOURCE 
MODULES. DECKS 
AND BUILD UTILITY 
DIRECTIVES DECKS 



GENERATES 

MPLINK 

DIRECTIVES 




CCP 

LOAD 

FILE 



READY FOR 

DOWNLINE 

LOADING 



INITIALIZES 

VALUES IN LOAD j,, 

_ _ MODULE FILE ^Vr 

y IMAGE l_OAD* ° 
(INITIALIZED) 



OTHER UPDATED 
LOAD MODULE 
TYPE FILES 
(OVERLAYS MUX 
LEVEL CODE) 

M-1063 



Figure 1-1. Producing a CCP Downline Load File 



1-2 
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Parameters are separated by commas. Parameters usually 
specify values (such as the size of an NPU memory, or 
files (such as an application program name). 



GENERAL DATA FORMAT INPUT TO THE UTILITIES 

The data inputs to the utilities are modules in object code 
format that are generated by the CYBER Cross PASCAL 
compiler, by the CYBER Cross macroassembler, or by the 
CYBER Cross microassembler. At the time of use, the 
object code modules can be separate files newly produced 
from one of the assemblers or compilers, separate files 
read from magnetic tape or mass storage, or selected 
records read from a program library. 



OUTPUTS FROM THE UTILITIES 

When used with NOS installation techniques, the principal 
output from the Expand/ Autolink/Link/Editor utilities is 
an initialized memory image load module on mass storage 
in the host computer. This load module can then be 
converted by the Expand utility and the Load File 
Generator (LFG) into a downline loading, formatted file. 



A similar use of the Link/Editor utilities operating under 
NOS/BE produces an initialized memory image load 
module on mass storage in the host computer. This load 
module can then be converted into a downline loading 
formatted file. 

Optional outputs from various utilities include load maps, 
listings of all modules, buffer space reports, and 
diagnostic reports. 

The principal output from the library maintenance utility 
is a new, indexed library of the selected on-line NPU 
modules in object code format. All program libraries are 
held on the CYBER host's mass storage. Object code 
modules selected from any library are used to build a new 
load file for the on-line CCI system. The library 
maintenance utility could be used to build a new CCP 
library. 

Another output of the library maintenance program is a 
directory to the programs on the library, together with 
information about these programs. 
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LIBRARY MAINTENANCE PROGRAM 



INTRODUCTION 

The library maintenance program, MPLIB, can be used 
with CCP or CCI, but currently is used only with CCI. 
The utility uses a set of directives operating on a set of 
object code files to generate a new library. Two files are 
normally used: 

■ An object code file which contains the object code 
for modules that are to be added to the new 
library, or which are to replace existing object 
code modules by the same name which are already 
on the old library. This file is required. If there 
is no old library, the modules on the file create a 
library. 

• The old library file. This file, though optional, is 
normally always present. 

The user has the option of ordering listings of the new 
and/or the old libraries. 



MPLIB INPUTS 

The library maintenance program requires two files: a 
directives file and the object code file which contains the 
modules used to generate the library. If a library has 
already been built, MPLIB also requires the old library file. 

There are also several calling parameters that are 
associated with the library maintenance utility. These 
parameters are discussed in the Executing MPLIB 
subsection. 



The relocatable object code format of these modules is 
given in appendix F. Object programs that replace old 
programs of the same name are added to the new library 
at the same relative position as the replaced module. 
New object code programs that were not on the previous 
library are added to the end of the new library in the 
order in which they occur on the object file. MPLIB adds 
a directory record to this file. 

The default name of this file is LGO. 



MPLIB OLD LIBRARY FILE 

This file was created by a previous run of MPLIB. Note 
that once a library file has been created, it cannot be 
modified by MPLIB. The method of modifying a library 
file is to create a new file. 

The format of a library file is shown in figure 2-1. The 
first record of the file consists of the file name and the 
library directory. Each program in the library has an 
entry in the directory. Following this is the object code 
of each program. Each program is contained in a single 
record; the records appear in the same sequence as their 
entries in the directory. 

The default name of this file is OLDLIB. 



MPLIB OUTPUT FILES 

MPLIB provides two output files: the new library file and 
an optional listing of the new and/or the old library file. 



MPLIB DIRECTIVES FILE 

This file contains the directives in the order in which they 
are to be executed. The directives are of three types: 

• Those which cause modules to be selected for the 
library, or deleted from an existing library. 

■ A directive that allows the operator to order a 
listing of the new and/or the old library. 

• A directive to terminate the library maintenance 
operation. 

The default name of this file is INPUT. 



MPLIB OBJECT CODE FILE 

This file contains the object code of modules that: 

• Are used to construct a new library for the first 
time 

• Replace existing modules of the same name on the 
old library (the new library contains these modules) 



NEW LIBRARY FILE 

The new library file has the same format as the old library 
file; however, it contains additional modules and 
substituted modules (as specified by the directives), and 
lacks modules which the directives have deleted. 

Default name of the new library is NEWLIB. 



LIBRARY LISTINGS 

The optional new and old library listings are requested by 
an MPEDIT directive. If the directive is used, the listing 
file is sent to the output file. The user can order printed 
copies of the file using the techniques described in the 
NOS/BE Reference Manual. 

A library listing consists of a program names, program 
lengths, and program entry points for each of the 
programs on the library. A sample listing is shown in 
figure 2-2. 

If both the new and the old library listings are ordered, 
the old library is the first part of the output file and the 
new library is the second part. 
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LIBRARY FILE FORMAT 



PROGRAM NAME AND 
ENTRY POINT RECORD 



END OF RECORD 



OBJECT PROGRAM 1 



END OF RECORD 



OBJECT PROGRAM 2 



END OF RECORD 



OBJECT PROGRAM n 



END OF FILE 






* 



♦ — • 



h- 



1 



FORMAT OF PROGRAM NAME 
AND ENTRY POINT RECORD 



OBJECT PROGRAM 1 INFORMATION 



OBJECT PROGRAM 2 INFORMATION 



OBJECT PROGRAM n INFORMATION 



END-OF-TABLE WORD 1 



FORMAT OF OBJECT PROGRAM 



OBJECT CARD IMAGE 1 (NAM) 
(16 SIXTY-BIT WORDS) 



OBJECT CARD IMAGE 2 
(RBD OR ENT OR EXT. ETC.) 



OBJECT CARD IMAGE n (XFR) 



FORMAT OF OBJECT PROGRAM INFORMATION 
(IN THE PROGRAM NAME AND ENTRY POINT RECORD) 
89 53 47 41 36 20 23 15 



NOTE: AN OBJECT PROGRAM IS ONE 
LOGICAL RECORD. WITH A 
MAXIMUM SIZE OF 4.992 
SIXTY-BIT WORDS (312 OBJECT 
CARD IMAGES). 



59 



41 



ALL ONES 


ALL ZEROS 



(END-OF-TABLE WORD) 



1 


cl 


c2 


c3 


c4 


c6 


c6 





PROGRAM 
LENGTH 




59 







2 


OBJECT PROGRAM SIZE (60-BIT) 




SB 




36 29 23 17 11 5 


3 





d 


c2 


c3 


c4 


c5 


c6 




a 




35 29 23 17 11 5 


4 





cl 


c2 


c3 


c4 


c6 


c6 



59 


35 


• 
29 


23 


17 


11 


5 





d 


c2 


c3 


c4 


c5 


c6 



NOTES: 1. WORD 1 CONTAINS THE SIX-CHARACTER 

NAME AND THE LENGTH OF THE PROGRAM 
IN 16-BIT WORDS. 

2. WORD 2 CONTAINS THE LENGTH OF THE 
OBJECT PROGRAM IN 60-BIT WORDS. 

3. WORDS 3 THRU n CONTAIN THE SIX- 
CHARACTER NAMES OF ENTRY POINTS 
IN THE PROGRAM. NOTE THAT A 
PROGRAM MAY HAVE NO ENTRY POINTS. 



Figure 2-1. Format of an MPUB Library File 



EXECUTING MPLIB 

The utility is executed by attaching the MPLIB permanent 
file, and then using the name call statement (see the 
NOS/BE Reference Manual). 

Five parameters are associated with the MPLIB name call 
statement. All of these parameters specify files. Format 
of the statement is: 

MPLIB[,lfnl,lfn2,lfn3,lfn4,lfn5.] 

where lfnl is the object code input file name (default 
name is LGO); Ifn2 is the input directives file name 
(default name is INPUT); lfn3 is the output listing file 
name (default name is OUTPUT); lfn4 is the old library 
file name (default name is OLDLIB); and lfn5 is the name 
of new library file created by the MPLIB run (default 
name is NEWLIB). 

The parameters are positional. Therefore, if a parameter 
is omitted, its delimiting commas must be retained. If a 
call uses all default parameters, all commas are omitted. 
Such a default call is terminated with a period to indicate 
the lack of delimiting commas. For example: 

MPLIB. 
This call produces: 



a new library, NEWLIB (lfn5) 

from an old library, OLDLIB (Ifn 4), and an object 
code input file, LGO (lfnl) 

as commanded by the directives file, INPUT (lfn2) 

with any listings output to the listinq file. 
OUTPUT (lfn3). 



Example 2: 

MPLIB,„OLDOBJ,NEWOBJ. 

This call uses default parameters for the object and 
directives files, and for the listing file. It names the new 
and old libraries, however. The call produces: 

• a new library, NEWOBJ (lf n 5) 

• from an old library, OLDOBJ (Ifn 4), and an object 
code input file, LGO (lfnl) 

• as commanded by the directives file, INPUT (lfn2) 

• with any listings output to the listing file, 
OUTPUT (If n3). 
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NPLI* CI»EtTTVES 



*»LL. 

*LST»NEW. 
• END. 



COPT ALt CF LGO 



SCFLIB 
StFLIt 
SCFtlB 



NEW LIBRARY 
PROGRAM LENGTH 



ZERCX 

BEGINX 

PtIM« 

JUfPS 

ACORFS 



CC*C 

COCfc 
C04C 
CC1C 
COIA 



PBINOO 


CO?«! 


PPIKC1 


COIF 


PBLN02 


OOIF 


PBLNC3 


CC1F 


Pfl*i06 


C02C 


PBINC8 


CC1F 


PBCETC 


coot 


PBPUTC 


CCC7 


PPCALl 


CCCE 


PhSTOR 


CC2? 


P8FIIE 


G02P 


prtrT 


crsc 


FBAPAS 


0012 


PBLHAS 


oooc 


PPCKAS 


OOCF 


PBSPAS 


cocc 


PBBEXI 


OOCF 


PBAEXI 


OOOE 


P6SETP 


0022 


PBCLPP 


OOOC 


PBCCttP 


OOlf 


PBROPG 


0010 



ENTRY POINTS 

ZERCX 

BEGINX 

Pf IMP 

JUPPS 

C IP ADC 
CCPIEV 
CCPCYC 

♦tcrlc 

ADORES 
CCPVER 
ACCRSU 

PPlfcOO 

PPLfCl 

PPLK02 

ppuo3 
p«>i*oe 

PPLKC8 
PBCETC 
PFFUTC 
PfiCM.l 
FKSTCP 

ppcf 

PPFF 

PllPT 

PBAPAS 

FBLPAS 

PPCPAS 

PBSPAS 

PBBEXI 

PBAEXI 

PBSETP 

PBCLRP 

PBCCHP 

PBRDPG 



PBPSKI , 

PBPUTP 

PBGETP 

PBSTPK 

UNI ECU 

OULOCK 

PPRTCD 

GENTRY 

OEXIT 

BUFNAI 



HSPHCS 
INPST7 



0013 
0017 
0011 
C013 
OOCF 
0011 
OCCP 
0C4B 
001E 
CC7t 



LISTSR 


C028 


PBSTCP 


001C 


PBSLJ 


CCC7 


PTTPIN 


0C2* 


PPSCIA 


C02r 


fCDPST 


OOCE 



ASrtSE 


CCCC 


NSPROI 


OOCF 


HS2PRU 


C14C 


HSPRUT 


0270 



OOOC 
0210 



PBPSWI 

PBPITP 

PBGETP 

PBSTPH 

UNLOCK 

CUICCK 

PPPTCO 

CE*T»Y 

OEXIT 

PBPELC 
P«»EL1 
PBGET1 
PBPFLZ 

FBLSGE 
PPLSPU 

PBSTCP 

PBStJ 

PTTPIN 

FPSftA 

PILT8 
PILT9 
PIITO 
PIIT4 
MlTl 
PJIT3 
PILTt 
PUTA 



HCCC9 

HIKSPT 

♦-TEPH2 

H2ISPT 

HXTPT 
HNTTPT 
HIATPT 
H2PTPT 

NAKHNS 

ACKHHS 

BISTAR 
BIOISC 
BIENTP. 

BIE010 



I*ST*7 



01A7 



TPST78 

BSCNSG 



01C1 
0020 



•IVC2C 
BIVC40 
BIV050 
BIC230 
BIC250 
BIC400 
BIC«1C 
6IC420 
BICOC 
BINTXT 
BINCCS 
BIHIC 
BIM*C 
BIMBC 
BIM4C 
BISTID 
BISTBI 
BISTRS 
BISTRC 

BTX10C 
BIX1«0 
BIC100 
BIC21C 
EIY35C 
•TCIAS 
BICCON 
BICVER 
8IBCTH 
BITER* 
8IC200 
FTK23C 
BIK25C 
8IT10C 
81X130 
BIX15C 
PIX160 
PIX170 
BIX1RC 
BIX190 
BIX20C 
BIX210 
P.IX2VC 
BIX250 
BIX30C 
BIX320 
BIX350 
BIX44C 
BIX«5C 
BIERRC 
6 1 TOO! 
BIOC09 

B27TPT 
P37TPT 

ACKCHS 
ACK1NS 
ECTBHS 
UACKBM 
TTCBRS 
OISCBP 
ENCBHS 
KAKBHS 



Figure 2-2. Sample MPLIB Library Listing 
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PDEXIT 


oc«c 


POEXIT 


PNTMLO 


0098 


PNTMLO 


PDSTTR 


C2B2 


PDSTTP 


PNCNTL. 


00S6 


PNCNTL 


PCTERf 


0011 


FCTFPP 


PHICR 


, 0026 


PKICR 


OLCIAG 


04PF 


UCIAG 


PNSTAT 


002F 


PNSTAT 


GLDMtX 


001? 


CLCKUX 


PN1LNS 


C077 


PN11NS 


PTCSOL 


C03* 


FTf SOU 


PN2LNS 


005C 


PK2LNS 


PT^sr« 


C07P 


pirsr* 


PNLNST 


CCB7 


PMKST 


PICtL^ 


CC*R 


ptceip 


PMT"l 


00<>F 


PN1TMI 


PTTYFl: 


0007 


FTTYHl 


PNTPLS 


000* 


PNTPIS 


PTTYT I 


Ot^f 


PTIYTI 


PM»nc 


C138 


pkfppc 


PT1YTC 


f.OCt 


PT1YTC 


PMBRO 


CCF7 


PMRPC 


PMWM 


COIF 


PNAMI 


PNCVIO 


CUP 


PfCVIO 


PNMN 


COC* 


PNP1N 


PKGvtr 


CO't'J 


PKfvir. 


P^S^">* 


COif 


fltffit 


PKCVLT 


CC1A 


p^rviT 


PM MM 


ct«r 


PM.Kil 


PHFPCE 


CC27 


PKFRCE 


PNRV»S 


oo?] 


pkpvp* 


PNPsr* 


00/2 


P*FSTA 


PKTfCC 


CC37 


fmcci 


PN^STA 


01?c 


p^si* 


PfcCPFl 


re at 


PKCFf l 


PtSKGE 


C12I 


PKSPGE 


PKGTCfi 


cc«c 


Pt fTCP 


CCFPU6 


0021 


CCEFIG 


P»>TCP5 


CPt* 


fmcps 


f.eCLP 


C02F 


PPCtP 


p^7lir 


f r^r 


p»>ri if 


PPCISP 


CCfF 


p»nsp 


P 1*0 ISC 


cr.fi 


FKC1SC 


PBITAD 


cc** 


ppic*r 


PNSMP 


for* 


pf;?*TP 


PP111 


cor 7 * r 


Hill 


P*.S»Vl 


0171 


pkspwi 


PPF**LT 


ciri 


PPH/IT 


PhSfOI 


COC 


pi^pdi 


PBPCN 


tot? 


PPPCK 


PKONF 


02C« 


P*CCNF 


TCTIKE 


0011 


TCTIHE 


PMNCS 


01AF 


PHH.CN 


TCSTAR 


OOCH 


USTAR 


fmpic 


TZf r 


PMMC 


1CST0P 


COCP 


TCSTCP 


PKDHE 


COD') 


PKPEIE 


PIOTBL 


COfll 


FICTBl 


PKFKAB 


006F 


PNEKAB 


K#1NS 


0018 


MAINS 


PKCISA 


01C5 


PKCIS* 








»IIH. 


fOT •: 


PkLIKF 









Figure 2-2. Sample MPUB Library Listing (Contd) 
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MPLIB DIRECTIVES 

There are six MPLIB directives. Four of them are directly 
concerned with chosing the programs that form the new 
libary. One of them selects the optional listings. One of 
them terminates the directives list. Except for the 
terminating statement, the directives can occur in any 
order. 

All directives begin with an asterisk (*); any directive can 
be terminated with an optional period. The general form 
of an MPEDIT directive is: 

♦DIRECTIVENAME [.parameter.] 

All directives begin in column 1 of a Hollerith coded card 
or card image. 

If there are no directives in the directive file, the old 
library is copied to the new library without alteration. 



of programs on the old program library, the names of all 
programs in the sequence must be identical to the new 
names. This form of the directive is particularly useful 
for adding new applications to a library, or replacing 
applications where the modular structure of the 
application has not changed. 

Note that a dollar sign ($) symbol can be substituted for 
the name of the first or last program on the object code 
file. 



•DEL. DELETES PROGRAMS FROM THE LIBRARY 

The *DEL directive suppresses copying the specified 
program or programs from the old library to the new 
library. There are two forms of the directive. The single 
program deletion format is: 

*DEL,modC.] 



•ALL, ADD ALL THE OBJECT CODE FILE PROGRAMS 
TO THE NEW LIBRARY 



where mod is the program name. If the name exceeds six 
characters, MPLIB discards the seventh and following 
characters. 



The *ALL directive causes MPLIB to copy all of the 
programs on the object code file to the new library file. 
It is used to create a new library for the first time. It can 
also be used for adding a set of new modules (such as a 
terminal interface package) to an existing library. 

Format of the directive is: 

*ALL[.] 



•PUT, ADDS PROGRAMS TO THE LIBRARY 
FROM THE OBJECT CODE FILE 

The *PUT directive has two formats: 

• One form adds a single program (module) from the 
object code file to the new library file. 

■ The other form adds a sequence of programs from 
the object code file to the new library file. 

The directive is used to select programs for inclusion in 
the new library. It is also used to replace programs on the 
old library file with programs of the same names from the 
object code file. The utility can be used in the latter 
manner to update a program library. 

The single program format of the directive is: 

*PUT,mod [.: 

where mod is the program name. It starts with a letter. 
If the name exceeds six characters (letters or numbers), 
MPLIB discards the seventh and following characters. The 
names on the old library are no longer than six characters. 

If a program is replaced with a new version of the 
program, the new program has the same place in the new 
library index and in the library file. 

The series program format of the directive is: 

*PUT,modl-mod2[.] 

where modi is the name of the first program in the object 
code sequence, and mod2 is the name of the last program 
in the sequence. Names are truncated to six characters as 
necessary. If the programmer wishes to replace a series 



The series program deletion format is: 

*DEL,modl-mod2[.] 

where modi is the first of the programs to be deleted 
during copying, and mod2 is the last program to be deleted 
in the sequence. All programs on the library index 
between (and including) the named programs are deleted. 
(A listing of the old library can be produced by a *LST 
directive to find the order of programs on the library.) 

Note that a dollar sign ($) symbol can be substituted for 
the name of the first or last program on the library file. 



•SUP, SUPPRESSES COPYING PROGRAMS FROM 
THE OBJECT CODE FILE TO THE LIBRARY 

The *SUP directive is used only in conjunction with the 
•ALL directive. It allows the user to suppress copying of 
the specified program or programs from the object code 
file to the new library. There are two forms of the 
directive. The single program suppression format is: 

*SUP,mod[.] 

where mod is the program name. If the name exceeds six 
characters, MPLIB discards the seventh and following 
characters. 

The multi program suppression format is: 

•SUP,modl-mod2[.] 

where modi is the first of the programs to be deleted 
during coping, and mod2 is the last program to be deleted 
in the sequence. All programs on the object code file 
between (and including) the named programs are deleted. 

Note that a dollar sign ($) symbol can be substituted for 
the name of the first or last program on the object code 
file. 



•LST, LIST A LIBRARY 

The *LST directive is used to request a listing of the new 
library or a listing of the old library. Formats for these 
requests are: 
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*LST,OLD[.J for the old library listing *ENDC] 

*LST,NEWC.] for the new library listing 

„ h „ ,. . MPLIB ERROR MESSAGES 

If both listings are requested, the old library occurs first 

on the output file. 

Library maintenance error messages are listed in table 

„„. „._, TUC . ,„ DADV „,,„„.„-, rtDCD ATir.M B ~ 2 of a PP end >x B - The action that should be taken when 

•END. END THE LIBRARY BUILDING OPERATION these messages appear is also given ,„ that tab , e> 

The *END directive terminates the directives file. Form 
of the directive is: 
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VARIANT DEFINITION HANDLING UTILITY, EXPAND 



INTRODUCTION 

Expand is a special purpose utility which provides a 
simplified user interface to the CCP installation process. 

Two directives are used to describe the NPU variants (see 
glossary) and the CCP downline load file. 

The CCP user provides an indirect access permanent file 
called USERBPS which contains the CCP variant 
definitions for the system to be installed. This utility 
expands the USERBPS configuration definitions into a set 
of directives used by the appropriate build step. Two 
types of definitions are found on USERBPS: 

■ VRD, a variant definition. This expands 
corrections to the update input decks (see figure 
1-1 and the NOS Installation Handbook). 

■ LFD, a load file definition. This expands the Load 
File Generator utility directives for the load file 
generation build step (see figure 1-1 and the NOS 
Installation Handbook). 



EXECUTING EXPAND 

Expand is called automatically by the appropriate CCP 
installation build steps. The user must, however, know the 
form of the variant definitions entered in USERBPS. 

The variant parameters file (USERBPS) can contain any 
number of CCP variant and load file definitions. The user 
must supply a variant name (see figure 1-1) for each 
variant to be processed. 

During the variant build step, the user specifies the 
variant name. The Expand utility is automatically called 
to search USERBPS for the specified variant name. The 
utility uses the associated definition to generate a set of 
Update directives. These expanded definitions are used to 
generate input for the Autolink and MPEDIT utilities, 
which are described elsewhere in this manual. Note that 
CCP installation build steps also call Autolink and 
MPEDIT automatically. 



SYNTAX OF EXPAND VARIANT 
DEFINITION PARAMETERS 

The general definition format is: 

keyword=type, parameterl=valuel,...,parametern=valuen. 

Some parameters optionally take multiple values. 
Multiple values are separated by slashes. 

The following rules apply to all USERBPS definitions: 

• The keyword identifies the type of definition 
(VRD or LFD). 

• Blanks are ignored. 

• All definitions terminate with a period. 



Omitted parameters do not need delimiting 
commas. 

If a definition requires two or more lines, the first 
nonblank character of each continuation line is a 
plus sign (+). 

All values for a parameter must appear in a single 
line. 

The first nonblank character of a comment line is 
an asterisk (*). 



VRD, DEFINES A CCP VARIANT 

Format of the VRD definition in USERBPS follows. Note 
that the order of the last three parameters must be as 
shown (NP, CP, and TR). 

VRD=vn, VT=vl[/v2/v3], SZ=xK, TS=[tl/t2/.../t]n, NL=n, 
+ NP=id, CP=id, TR=pal-idl/pa2-W2/..../pan-idn. 

VRD identifies the entry as a variant definition and 
specifies the variant name. The name is a three- 
character string used by the CCP variant build step to 
create unique, permanent file names. 

VT specifies variant type. One value is required; two 
others are optional: 

vl - is required, its values can be F, L or R where 

F indicates a front-end 255X; the unit includes 

a HIP but no LIP. 

L indicates a local 255X; the unit includes a HIP 

and a LIP. 

R indicates a remote 255Xj the unit includes a 

LIP but no HIP. 
v2 - is optional; its value is D indicating the variant 

should include on-line diagnostic support 

modules. 
v3 - is optional; its value is T indicating the variant 

is a test build. A test build includes modules 

for TIPDEBUG, TESTGEN, TUP (the variable 

TOTUP is set to 1), and CONSOLE. 

Examples of VT parameters are: 

VT=L/D/T Specifies a test build for a local NPU with 
diagnostics. 

VT=F/D Specifies a normal build for a front end 
NPU with diagnostics. 

VT=R Specifies a normal build for a remote NPU 

without diagnostics. 

SZ specifies the variant memory size. Allowable values 
are: 

65K 65,536 words of memory 

81K 81,920 words of memory 

96K 98,304 words of memory 

128K 131,072 words of memory 
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The SZ memory size must not conflict with the 

corresponding NPU definition in the network definition 

language, NDL (see the Network Definition Language 
Reference Manual). 

TS specifies the TIPs to be included in this variant. TS 
can assume up to ten independent values. 

A indicates the ASYNC TIP is included. 

E indicates the ASYNC extended option (ASYNCEXT) 

is included. 
H indicates the HASP TIP is included. 
M indicates the Mode 4 TIP is included. 
X indicates the X.25 TIP with PAD sub TIP is included. 
B is reserved for future use. 

1 indicates a Userl TIP is included (TIP provided by 
user). 

2 indicates a User2 TIP is included (TIP provided by 
user). 

3 indicates a User3 TIP is included (TIP provided by 
user). 

4 indicates a User* TIP is included (TIP provided by 
user). 

Examples of the TS parameter are: 

TS=A/E/M NPU has the Mode 4 TIP, and the 

ASYNC TIP with extentions. 

TS=H/X NPU has the HASP TIP and the X.25 

TIP with PAD subTIP. 

TS=A/E/M/X/1 NPU has both normal and extended 
versions of the ASYNC TIP, the Mode 
4 TIP, the X.25 TIP with the PAD 
subTIP, and one user-written TIP 
designated as user TIP 1. 

NL specifies maximum number of 255X lines (ports) to be 
configured for this variant. The associated nl decimal 
value ranges between 1 and 254. 

NP specifies the NPU node ID for this NPU. The 
associated np decimal value ranges between 2 and 255. 
The value must not conflict with the corresponding NPU 
definition in the network configuration file, NCF, which 
was generated during installation by network definition 
language directives. 

CP specifies the host coupler decimal ID if the variant 
type is front-end (F) or local (L). CP is omitted for 
variant type remote (R). The cp value must not conflict 
with the corresponding coupler statement in the network 
configuration file, NCF, which was generated during 
installation by network definition language directives. 

TR specifies the trunks if the variant type is local (L) or 
remote (R). TR is omitted for variant type front-end (F). 
Two values are required for each trunk: port address (pa) 
in hexadecimal, and the three-character variant name of 
the NPU at the other end of the trunk. All trunks are 
specified by one TR parameter. Value pairs are separated 
by slashes (/). An NPU can have one to eight trunks. For 
example: 

TR=l-RMl/2-RM2/3-RM3 

specifies a local variant with three trunks. These are 
connected at ports 1, 2, and 3 to remote NPUs RM1, RM2, 
and RM3 respectively. 



EXAMPLES OF VRD DEFINITIONS 

Example 1: 

VRD=EX1, VT=L/D, SZ=81K, TS=A/M, NL=100, NP=11, 
CP=2, TR=l-RMl/2-RM2. 
This defines: 

• A local NPU with 81,920 words of memory having 
an NPU ID of 11 and a coupler node ID of 2. 

• This normal build includes two TIPS (Mode 4 and 
normal ASYNC) and on-line diagnostics. 

• Two remote NPUs are attached. Remote NPU 
RM1 is connected through trunk port 1. Remote 
NPU RM2 is connected through trunk port 2. 

• No more than 100 lines can be connected to this 
NPU. 

Example 2: 

VRD=EX2, VT=R/T, SZ=81K, TS=A/E/H/X, NL=127, 
NP=23, TR=3-L81. 
This defines: 

• A remote NPU with 98,304 words of memory 
having an NPU ID of 23. 

• This test build includes four TIPs: HASP, X25 with 
PAD subTIP, and both normal and extended 
versions of ASYNC. On-line diagnostics are 
omitted. 

• This remote NPU is connected on trunk port 3 to a 
local NPU with variant name L81. 

• No more than 127 lines can be connected to this 
NPU. 

Example 3: 

VRD=EX3, VT=F/D/T, SZ=128K, TS=A/E/M/H/X, 
NL=127, NP=30, CP=15. 
This defines: 

• A front-end NPU with 131,072 words of memory 
having an NPU ID of 30, and a coupler node ID of 
15. 

• No remote 255X units are connected to this NPU. 

• This test build includes all five standard TIPs and 
on-line diagnostics. 

• No more than 127 lines can be connected to this 
NPU. 

LFD, DEFINES A CCP LOAD 
FILE VARIANT 

The format of an LFD statement in USERBPS is: 

LFD=gn, LM=vvl-p21idl/..../vvn-p21idn. 

LFD identifies this entry as a load file definition, and 
specifies the load file name (gn). The gn value is a 
three-character string used by build step CCPGLF to 
create a unique permanent file name for the output file 
(see the NOS Installation Handbook). 
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LM specifies the CCP variant load modules to include in 
this load file. The multiplex subsystem firmware (phase 1) 
and dump bootstrap load modules are automatically 
included in every load file. The on-line diagnostics and 
remote 255X dump/load overlay load modules are 
automatically included if files ZDGN and/or ZREM are 
present. 

The associated vvi-p21idi value consists of two parts: (1) 
vvi is the three-character name of a variant load module 
(permanent file name = Zvvv) generated by the CCP 
variant build step; (2) p21idi is the three character name 
specified for this variant as the phase 2 load ID in the 
corresponding NPU statement in the network con- 
figuration file. 

One vvi-p21idi value is required for each variant to be 
included in the load file. Successive vvi-p21idi values are 
separated by slashes (/). 



EXAMPLES OF CCP LOAD FILE DEFINITIONS 

Example 1: 

LFD=EX4, LM=EX1-N11/EX2-N23/EX3-N30. 

defines a load file containing the variants created in the 
three VRD variant definition examples given previously. 

NOTE 

In LFD examples, p21idi naming follows 
the load file generator convention: the 
name starts with the letter N and is 
followed by the two-digit NPU node ID. 

Example 2: 

LFD=EX5, LM=EX3-N30. 

This defines a load file containing the variant shown in the 
third VRD example given previously. 



EXPAND ERROR MESSAGES 

All error messages generated by the Expand utility are 
written to the file specified by the fourth parameter of 
the Expand name call statement. If no file name is 
specified in that parameter, error messages are written to 
the file with the local name, ERMSGF. During a variant 
build or a load file generation, errors are written to the 
output file. The messages appear on the listing from that 
build step. 

Each error message indicates the problem type (for 
example, a USERBPS file error or a macro text file 
error). In some cases, the erroneous text is also copied 
into the error message. 

An error message has one to three lines: 

• The first line is the text line. It contains the text 
passed to the Expand utility from the build 
procedure step. 

• The second line specifies the primary USERBPS 
line of a variant or load file definition. 

• The third line is an associated variant definition. 

Some error messages omit one or more of these lines. 

In some cases, an arrow occurs underneath the text line of 
an error message. Any text to the right of the arrow was 
not processed by Expand at the time it detected the 
error. For example: 

LN = EX3 



In this case, the error occurred either in the symbol LN or 
in the equal sign. Expand had not processed the EX3 
symbol. 

The Expand utility error messages are shown in table B-2 
of appendix B. The action to be taken when these 
messages appear is also given in that table. 
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AUTOLINK UTILITY 



INTRODUCTION 

Autolink generates the MPLINK directives for CCP. It 
simplifies MPLINK use and provides an optimized MPLINK 
input directives file. By optimizing the location of 
executable modules in NPU, Autolink provides the 
maximum number of buffers. These buffers can be 
assigned for message processing purposes. 

If standard CCP installation procedures are used, this 
program is generated by the build procedures from the 
release tapes; its use is generally invisible to the system 
installer. 



CCP APPLICATION PROGRAM TYPES 

A CCP application program (normally called an 
application) is a group of modules working together to 
perform some major system function. There are two 
types of CCP applications: 

• Base applications that must be included in every 
CCP system. Most of these applications are 
located in an unpaged area in main memory. One 
of them, the service module, is located in the 
paged area of main memory. Parts of the service 
module that cannot fit on this page are located in 
the paged area of main memory. 

• Terminal interface packages (TIPs). This category 
also includes the host interface package (HIP) and 
the link interface package (LIP). These 
applications are normally located in the paged 
area of extended memory, although individual 
application modules can be included in paged or 
unpaged main memory. 

Table 4-1 relates the standard CCP applications names to 
the common names for these applications 

The NPU memory is paged. Current page length for CCP 
is 8192 words. CCP uses one page located at address 
2000.16; all other pages are imaged at this page, but are in 
fact located in extended memory (addresses higher than 
65,536). Having all modules of an application located on 
the same computer page speeds processing. Autolink 
allows the user to specify that a module is to be loaded on 
the same page as its application; Autolink can locate 
other modules elsewhere to optimize buffer space or to 
avoid page overflow. Paging and the associated 
addressing problems caused by paging are discussed in 
detail in the Link utility section of this manual. 



AUTOLINK INPUTS 

There are two types of Autolink input files: directives and 
object code files for the directives to act upon. These are 
shown in figure 4-1. 



Autolink Input Directives 

The user specifies the linking operations to be performed 
by a series of input directives to Autolink (this is 



TABLE 4-1. CCP APPLICATION NAMES 



Name 



ASYNC 

ASYNCEXT 

BASESYS 

CONSOL 

HASPTIP 

HIP 

LIP 

INITIAL 



Common Name/Function 



Asynchronous Terminal Interface 
Package 

Extended Asynchronous Terminal 
Interface Package 

Base System Modules 

NPU Console Package 

HASP Terminal Interface Package 

Host Interface Package 

Link Interface Package 

Initialization Routines 



IVT 


Interactive Virtual Terminal 
Common Routines 


MODE4 


Mode 4 Terminal Interface Package 


OLDSYS 


On-line Diagnostics 


PIBOF2 


Buffer Space 


PIDTBL 


ID Table (this is always the last 
application specified) 


SVMOBULE 


Service Module 


TUP 


Test Utilities Package 


X25L2 


X.25 TIP Level 2 (Frame Handling) 


X25L3 


X.25 TIP Level 3 (Packet Handling) 


X25PAD 


PAD SubTIP for the X.25 TIP 


X25TIP 


X.25 Terminal Interface Package | 



automatic if the standard system is used). The directives 
are contained on an input file. Four types of directives 
exist: 

• Directives specifying the size and paging 
characteristics of the NPU memory. Reserved 
areas can also be specified (the characteristics of 
a reserved area are discussed later). 

• Directives defining the applications and 
associated modules to be used in the build. These 
directives also specify whether the module must 
be loaded on the same page as the other modules 
of the application. 
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Figure 4-1. Autolink Logical Flow 



Directives defining the optional Autolink reports. 

Passive MPLINK directives. These directives are 
not processed by Autolink, but are saved and are 
copied into the output file Autolink generates for 
MPLINK. 



Autolink Input Modules 

Modules are input to Autolink from special object code 
files (see figure 1-1). These files can be the direct output 
of a Cross assembler or compiler, or a library file created 
by the CCP installation procedures. In either form, the 
object code is relocatable. The format of this relocatable 
code is given in appendix F. 



OUTPUTS FROM AUTOLINK 

The principal Autolink output is a file of directives for 
MPLINK. The other outputs are the Autolink reports and 
a fatal error file (see figure 2-1). The reports are: 

■ Buffer space report 

• Output directives report 

■ A memory map 

■ An input directives report 



EXECUTING AUTOLINK 

The CYBER Cross System must be installed for Autolink 
to be executed. Autolink's name call statement is of the 
form: 

ALKOVL(files) 

If the user follows the installation procedures given in the 
NOS Installation Handbook, the input files necessary for 
Autolink's proper operation should be available at Autolink 
execution time. 



AUTOLINK INPUT FILES 

Inputs are presented to Autolink on three input files: 

■ The input directives file (required) 

• An object code file which contains modules 
(required) 

• An object code library file (optional) 

INPUT DIRECTIVES FILE 

This file contains the directives necessary to generate the 
MPLINK directives file. The MPLINK directives contain 
all control information needed by the Link utility to 
produce the memory image load module (ABSOLMP) file 
and the symbol table (SYMTAB) file. These two files are 
the required inputs to the Edit utility. See figure 1-1. 
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OBJECT CODE MODULES FILE 



FATAL ERROR MESSAGE FILE 



This file of object code modules contains all the modules 
that are to be linked. These modules are the output of a 
CYBER Cross System compiler or assembler. 



LIBRARY FILE 

This optional file contains the object code for modules 
that are grouped into a library. The function of this file is 
identical to that of the object code module file; the 
library provides a second source of object modules. 



AUTOLINK OUTPUT FILES 

There are four types of Autolink output files: 
■ Output directives file 

• Fatal error message file 

• Listings files 

• Temporary file for saving passive MPLINK 
directives 

The output directives file is normally left as an on-line 
mass storage file so that it can be used as the input to the 
MPLINK utility. 

Information generated by fatal error processing is stored 
in the fatal error message file. If no fatal error occurs, 
this file is empty. 

The user can select optional reports, the output directives 
file, or a listing file contain one or more reports. 

A temporary file is used to save the passive MPLINK 
directives until they are needed in producing the output 
directives file. The contents of the file are not available 
to the user. 

OUTPUT DIRECTIVES FILE 



This file's message specifies the cause of the fatal error 
and contains diagnostic comments. Standard CCP 
installation procedures copy the fatal error file to the 
output file and normally terminate the variant build step. 



EXECUTING AUTOLINK 

Autolink is executed through the name call statement: 
ALKOVL(files). If the user follows the installation 
procedures given in the NOS Installation Handbook, the 
input files necessary for Autolink's proper operation 
should be available, and rewound at Autolink execution 
time. 

Autolink's name call statement contains eight file names. 
The names must appear in the order given. If a name is 
omitted, its delimiting commas must remain. Format of 
the Autolink name call statement is: 

ALKOVL(lfnl,lfn2,lfn3,lfn4,Ifn5,lfn6,lfn7,lfn8) 

where the file names are defined as follows: 

lfnl - the name of the file containing the input 

directives to Autolink. Default is TAPE1. 
Ifn2 - the name of the file containing the main 

object code input. Default is TAPE2. 
Ifn3 - the name of the file containing the object 

code library. This is the secondary object 

code input and is optional. Default is TAPE3. 
Ifn4 - the name of the output directives file. 

Default is TAPE4. 
Ifn5 - the name of the reports file. This file 

contains all reports and informative 

messages. Default is TAPES. 
Ifn6 - the name of the provisional file that stores 

the passive MPLINK directives. Default is 

TAPE6. 
Ifn7 - the name of the fatal error file. The file is 

generated only in the case of a fatal error. 

Default is TAPE7. 
Ifn8 - the name of the error file. Default is TAPE8. 



This file contains the MPLINK directives that are 
generated by the Autolink processing its own input 
directives. The passive directives that were used as 
inputs to Autolink are copied to the MPLINK directives 
file. The Autolink output file is used as the directives 
input to MPLINK. 

Any fatal error prevents generation of the output 
directives file. 



LISTING FILE 

This file contains any operator-requested reports, as well 
as any informative messages generated during Autolink 
processing. Informative messages are either warnings 
that indicate non-fatal input directive error, or provide 
diagnostic information about the fatal error. 

Fatal errors that occur during the MPLINK directives 
generation prevent reports; fatal errors that occur during 
report generation can result in a partial report. The 
partial report information is not reliable. 



AUTOLINK DIRECTIVES 

Autolink directives are of two types: 

• Passive MPLINK directives that are not used by 
Autolink but are copied into the output directives 
file. 

■ Active Autolink directives, which are processed 
by Autolink to form an output directives file or a 
report, or both. Some of these directives specify 
the modules to be selected from the input object 
code files and how they are to be used in the 
build. Other directives specify the report or 
reports which Autolink is to generate. 

PASSIVE MPLINK DIRECTIVES 

Passive MPLINK directives allow the user to insert 
MPLINK directives directly; they are copied unaltered 
into the output directives file. 
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The group of passive MPLINK directives which Autolink 
can use is: 

• *COM which defines the blank common area 

• *COR which defines the size of the NPU memory 
to be used for the build 

• *DAT which defines the labeled common area for 
PASCAL tables 

• *DSTK which defines the PASCAL 
reentrant/recursive routines stack area used by 
MPLINK 

• *DMP which orders a hexadecimal dump of the 
load file image 

• *DVAR which defines the dynamic area for 
PASCAL variables 

• *ENT which defines an entry point for a module 

• *LIB which defines the library file used to resolve 
unsatisfied externals 

• *SYN which defines a synonym for a module name 
or entry point 

• *SYSID which defines the system name and header 
record for the load file 

These directives are described in detail in the Link utility 
section of this manual. Other MPLINK directives cannot 
be used by Autolink. 



ACTIVE AUTOLINK DIRECTIVES 

Active Autolink directives are processed by Autolink and, 
in most cases, generate MPLINK directives for the output 
file. A directive consists of a directive name followed an 
equal sign and a parameter list: 

DIRNAME = parameter list 

Blanks are ignored. 

Active Autolink directives are summarized in table 4-2. 

The order of the directives is significant: 

■ APPL directives must be entered before MOD 
directives. APPL directives define the 
applications to be used in the build. The order of 
entering APPL directives with respect to one 
another has an effect which is explained in the 
Special Considerations for Using Autolink 
subsection. The last application must be PIDTBL. 

■ RPT=INFO turns on the input directives report. 
Any input directives entered ahead of this 
directive are omitted from the report; all 
directives following the RPT=INFO directive are 
included. 

• MOD directives must follow all other directives. 
The order of entering MOD directives with 
respect to one another has as effect as explained 
in the Special Considerations for Using Autolink 
subsection. 



TABLE 4-2. SUMMARY OF AUTOLINK DIRECTIVES 



Directive 



APPL 
BUFSPSIZE 

CORESIZE 
DEF 

DEFBASE 
HOD 

PAGES IZES 

PAGEREG 
RESERVE 

RPT 



Description 



Defines names of all applications 
that can be used in any system 
build. 

Specifies the memory sizes to be 
used in the buffer space report; 
that is, several trial computer 
sizes can be used. 

Specifies the memory size of the 
NPU which is to receive the build. 

Specifies the applications to be 
used in this build. 

Specifies base applications which 
must be used in every build. 

Defines the module name, and asso- 
ciates the module with one or more 
applications. 

Specifies the size of a page 
(currently, CCP cannot use more 
than one size). 

Specifies page register number. 

Specifies reserved areas of main 
memory. 

Specifies reports to be generated 
as part of Autolink run. 

rpx=BUFSP specifies the buffer 

space report. 
rpx=DIR specifies the output 

directives report. 
rpx=MAP specifies a main memory 

map. 
rpx=INFO specifies a list of 

the input directives and 

application lengths. 



NOTE 

If the order of the MOD directives is the 
same as the order of the modules in the 
object code input file, the execution speed 
of MPLINK is greatly increased. 



Comments for Directives 

Comments can appear anywhere in the input directives 
file. Comments are delimited in the usual PASCAL 
syntax fashion: 

• The comment starts with an ASCII underscore (-). 
This is the same as the bent arrow W in CDC 
graphics. 
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The comment ends with an ASCII question mark 
(?). This is the same as the down arrow (+) in CDC 
graphics. 



APPL, Specifies Applications 

The APPL directives identify the applications that 
comprise the system. An application consists of a group 
of modules performing a set of related functions. The 
group is identified by the single application name. 

Only one application name is used in each application 
directive. Every application referenced by a MOD 
directive must have an APPL directive. No more than 60 
applications can be defined. 

The format of an APPL directive is: 

APPL=appl [(ADDR = $nnnn)] 

where appl is the user supplied name of the application. It 
consists of one to six letters and digits. ADDR is an 
optional parameter specifying a starting address ($nnnn) 
for the application in hexadecimal. 

The last application directive to be entered must be 
PIDTBL. The order of entering other APPL directives 
with respect to one another is explained in the Special 
Considerations for Using Autolink subsection. 



CORESIZE, Specifies the Memory Size of the Variant Build 



This directive specifies the memory size of the variant 
build for the NPU. The format of the directive is: 

CORESIZE=n 

where n is the memory size. Allowable values are: 64K 
(65,536 words of memory), 80K (81,920 words of memory), 
96K (98,304 words of memory), and 128K (131,072 words 
of memory). Default value is 128K. 



DEF, Specifies the Applications to be Included in the Build 



This directive allows the user to select applications for a 
variant build from the full set of applications specified by 
APPL directives. Any application specified by an APPL 
that is not included in a DEF directive is ignored. Format 
of the directive is: 

DEF=appl 

where appl is an application name. It must be the same as 
the name for the application used in an APPL directive. 



DEFBASE, Specifies Base Applications 
that Must be Included in Every Build 

CCP requires some applications in every build. These 
base applications must not appear in DEF directives. Base 
applications are not included as optional applications in 
the buffer space report; however, the size of DEFBASE 
applications is calculated during that report's generation. 
Format of the directive is: 

DEFBASE = appl 



where appl is an application name. It must be the same as 
the name used for the application in the APPL directive. 



MOD, Specifies Where a Module 
can be Located during a Build 

This directive specifies the type of location available to a 
module during a variant build. Autolink handles up to 600 
MOD directives. 

MOD directives must follow all other directives. Each 
MOD directive associates a module with at least one 
application. All modules used in the build must have a 
MOD directive. 

Autolink generates an informative message if a MOD 
directive is issued for a module not available in one of the 
object code input files. Autolink generates a fatal error 
message if a MOD directive is issued for such a module 
belonging to a defined application. 

Note that a module directive can be carried on two or 
more physical lines as defined in the syntax rules given 
previously. 

The MOD directive consists of a name followed by a 
parameter list enclosed by parentheses. The parameters 
are separated by commas, and can appear in any order. 
Format of the MOD directive is: 

MOD^nodname (P=p , ADDR=addr , FILL , TH=topha t , 
APPL=appl 1/appl 2/ . . . /appln) 

where modname specifies the name of the module as it 
appears in the object code file. Only the first six 
characters of the name are significant. 

P - Specifies the type of paging to be used: 

P - indicates a pageable module. If a module is (1) 
pageable and (2) not specifically assigned a load 
address (ADDR parameter), then the module is 
located at the next available page address of the 
associated application, if possible. Otherwise, 
the module is located at the next available main 
memory address of its application. 

NP - indicates a non-pageable module. NP is the 
default value for the P parameter. 

F - indicates a module that is forced to reside with 
the paged portion of its associate application. 
An application cannot be assigned to a given 
page unless all its F-designated modules can fit 
on that page. 

R - indicates a reverse-loaded module; that is, space 
is reserved for the module based on a fixed 
ending address rather than a fixed beginning 
address. Unless otherwise specified, the ending 
address of the first R module in the directives 
file is the highest available main memory address 
(FFFE^g). Ending addresses of subsequent R 
modules start at a address one less that the 
beginning address of previous R module. 

ADDR - specifies the module is to located at an absolute 

address. 

addr is the absolute hexadecimal ($aaaa) address. For 
R modules, addr is the ending address; for all 
other modules, addr is the starting address. A 
fatal error results if one ADDR module 
overflows into the region assigned to another 
ADDR module. If the ADDR parameter is 
omitted, Autolink allocates a location according 
the requirements of other parameters. 
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FILL - indicates that the module need not be loaded in 
association with its application; rather, the module can be 
used to fill empty locations throughout main memory or 
paged memory that result from specifying reserved areas 
and absolute addresses, after assigning space for other 
some other types of modules (the filling operation is 
perfomed after several other types of processing have 
already been performed). Only if P=P can a FILL module 
be used to fill empty space on a page. 

TH - indicates a tophat module. A tophat module is 
normally a module that is called by several other 
modules. To minimize the code required to locate a 
tophat module's entry point, a small auxiliary piece of 
code is compiled with the module. This tophat code sets 
the page registers when other modules call this module. If 
a tophat module is located in a main memory, this 
operation is not necessary, so the tophat auxiliary code is 
discarded. Otherwise, if a tophat module is paged, the 
tophat code is located in main memory to set the page 
registers. 

tophat - is the name of the pageable module as it 
appears in the object text file. Only the 
first six characters are significant. 

APPL - specifies the names of all associated applications. 
There must be at least one APPL in every MOD directive. 

appl - is the name of an application as it appears in 
the APPL directive. 

An example of a series of MOD directives is given in 
figure 4-2. 



PAGEREG, Specifies Page Register Number 

If specified, this directive indicates the decimal page 
register number to be used for extended memory 
addresses. If no PAGEREG directive is included in the set 
of autolink directives, no page registers are explicitly 
included in the MPLINK directives. Format of the 
directive is: 

PAGEREG = n 

where n is the decimal page register number. For the 
CCP system, page register is used, and it designates the 
page starting at 2000ig. 



PAGESIZES, Specifies the Size of a Page 

This directive specifies the size of each page in pageable 
memory. Currently, CCP requires that all pages be of the 
same size. The format of the directive is: 

PAGESIZES=sl 

where si is the selected page size in K words (K=1024). 
The allowable values are 2K, 4K, 8K, and 16K. Default 
value is 8K. 



RESERVE, Specifies a Reserved Area of Memory 

This directive prohibits Autolink automatically locating 
modules in the specified area. However, Autolink can 
locate modules in a reserved area if an ADDR parameter 
in a MOD directive specifies that the module should be 
located in a reserved area. Each reserved area requires a 
separate RESERVE directive. Format of the directive is: 



RESERVE=addrb,addre 

where addrb is the lower boundary of the area in 
hexadecimal ($aaaa); and addre is the upper boundary of 
the area in hexadecimal ($aaaa). 



BUFSPSIZE, Specifies Memory Sizes 
for the Buffer Space Report 

This directive specifies the NPU memory size, or sizes, to 
be used in the buffer space report (see the form of the 
report in the Autolink Reports subsection). If BUFSPSIZE 
is not specified, the report is generated only for the 
memory size specified by the CORSIZE directive. Format 
of the directive is: 

BUFSPSIZE=sl,s2,...sn 

where si is the memory size to be included in the report. 
Allowable values are: 64K (65,536 words of memory), 80K 
(81,920 words of memory), 96K (98,304 words of memory), 
and 128K (131,072 words of memory). 



RPT, Specifies an Autolink Report 

This directive specifies a report to be generated by 
Autolink. Four reports are possible. Format of the 
directive is: 

RPT=rpt 

where rpt specifies one of the reports: BUFSP, DIR, MAP, 
or INFO. BUFSP specifies the buffer space report, DIR - 
specifies the output directives report, MAP - specifies a 
memory map report, and INFO - specifies the input 
directives report. The position of this card determines 
the content of the report: only directives that follow the 
card are included in the report. 



AUTOLINK REPORTS 

Autolink generates four optional reports, each of which 
can be selected by an RPT directive. If the BUFSPSIZE 
directive is used, it determines the size of memory for the 
buffer space report. 



BUFSP, BUFFER SPACE REPORT 

This report indicates the amount of main memory space 
available for assigning to buffers for a given NPU build. 
Buffer space is used for processing message traffic. 

The report format is governed by the BUFSPSIZE 
directive. BUFSPSIZE specifies all the memory sizes that 
are to be used while generating the report. A report 
includes all combinations of CCP applications that can fit 
into a permitted build configuration. For each of these 
combinations and memory sizes, the report gives the 
amount of space available for buffers. Note that the base 
applications do not explicitly appear in the report; 
however, the space used by these applications is 
calculated in generating the report data. 

Since the report requires considerable computation time, 
it should not be generated as a routine matter. A partial 
buffer space report is shown in figure 4-3. 
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HOD - PNSWML(P * F, ADDR * $2000, APPL = SVMODULE) 
MOD - PMAWAIT (P = P, APPL = SVMODULE) 



PNDSTAT(P = MP, APPL - SVMODULE) 



MOD - PGDSTAT(P = P, FILL, TH = PNDSTAT, APPL - SVMODULE/BASESYS) 



MOD = PIDTBL(P - HP, APPL = PIDTBL) 

MOD = GLOBL$(P = NP, ADDR - $0DA0, APPL = BASESYS) 



MOD - PIBUF2(P = R, ADDR - $FFFE, APPL = PIBUF2) 
MOD = PBREAD(P - R, APPL - CONSOL) 



MOD » MAIN$(P - R, APPL - INITIAL) 



MOD ~ R4M4IN(P * NP, FILL, APPL = MODE 4) 
MOD = R4M4CC(P = NP, FILL, APPL = MODE 4) 
MOD = R4M4TP(P = P, APPL = M0DE4) 



MOD = PTMD4TIP(P = F, APPL - MODE 4) 



MOD = PTASMOPS(P - F, APPL - ASYNC/ASYNCEXT) 
MOD - R4ASYT(P - P, APPL « ASYNC/ASYNCEXT) 



MOD » R4ASYKP = P, APPL ~ ASYNC/ASYNCEXT) 
MOD = ASYMSG(P = P, APPL = ASYNC/ASYNCEXT) 



The first set of modules specified (which is also the order of the modules on the object code input file) is 
from the service module. The leading module specifies (P = F) that this module must reside on the main memory 
page (starting address = 2000jfi) with other F designated service module routines* Since this is the first 
MOD statement, the beginning of this module is located at the beginning of the specified page. The second 
service module program can be paged anywhere. 

PNDSTAT, also a part of the service module, is not pageable; therefore, it must be located in main memory other 
than at the main memory page (locations 2000|g through 3FFF|g). The last service module program specified 
in the example is PCDSTAT. It can be paged, and must be vectored (using a tophat) to PNDSTAT. Since it is 
tied to PNDSTAT, that nodule cannot be pageable. The module can be used to fill holes in main memory, or on 
any page. Note that PGDSTAT is also a part of the base system application. 

PIDTBL is the module belonging to the last application. It is nonpageable. PIDTBL must be loaded as the 
assigned space above the last main memory sequential application; that is, normally, it is the application just 
below the beginning of the buffer area. 

GLOBL$ is a module that is assigned a specific address (ODAOig). It cannot be paged, and is a part of the 
base system. 

PIBUF2 begins the modules in the reverse loading sequence. The sequence ends with MAIN$. 

PIB0F2 defines the vector to the area used for buffers. The vector is at the upper end of main memory. The 
actual buffer space exists below the reverse-loaded modules, and normally above the last of the sequentially 
loaded modules (the last application in this sequence is PIDTBL). The application name is PIBUF2. 

PBREAD is also reverse-loaded. It is part of the console application package. The last address of PBREAD is 
one less that the first buffer word address. 

MAIN? is the last reverse-loaded module. Some of the reverse-loaded programs are not used during the normal 
on-line CCP processing, but are part of the initialization needed when CCP is configured after the downline 
load file is sent to the NPU. The buffer area is not determined until Autolink finishes its execution. 

The Mode 4 TIP has both pageable and nonpageable portions. It starts with two nonpageable modules, R4MRIN and 
R4M4CC. Both of these can be used to fill holes in main memory. The first pageable Mode 4 module, R4M4TP, 
preferably will be located at the beginning of its own page, since it is the first nonservice module specified 
by a P = P MOD directive. Only one of the Mode 4 modules must be located on the same page as its other modules 
(P = F), that is, the Mode 4 worklist handler, PTMD4TIP. 

The pageable Asynchronous and Asynchronous Extended TIP modules must be linked together on the same page, or in 
main memory. The TIP entry routine, PTASNOPS, indicates that is must reside on the same page as the other F 
modules (P ~ F) for these related TIPs. Some of the remaining modules are designated as pageable; others are 
required to be nonpageable. 

Figure 4-2. Example of MOD Directives 
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* 


X 


• 


X 


*♦ 


... 


* 


10531 


* 


26764 


* 


32131 * 


* 


X 


* 




* 




* 


X 


• 


X 


** 


... 


* 


8645 


* 


24929 


* 


31489 * 


* 




* 




* 




* 


X 


* 


X 


** 


— 


* 


16996 


* 


3234C 


* 


32340 * 


* 


X 


* 


X 


* 


X 


* 




* 


X 


** 


... 


* 


... 


* 


14487 


* 


32325 * 


* 




* 


X 


* 


X 


* 




* 


X 


** 


— 


* 


6605 


* 


23038 


* 


33176 * 


* 


X 


* 




* 


X 


* 




* 


X 


** 





* 


4961 


* 


21203 


* 


32534 * 


* 




* 




* 


X 


* 




* 


X 


** 


... 


* 


13272 


* 


28801 


* 


33385 • 


* 


X 


* 


X 


* 




* 




* 


X 


** 


— - 


* 


33C5 


* 


19833 


*■ 


32631 * 


* 




* 


X 


* 




* 




* 


X 


** 


... . 


* 


11882 


* 


28115 


* 


33482 * 


* 


X 


* 




* 




* 




* 


X 


** 





* 


9996 


* 


26280 


* 


3284C * 


* 




* 




* 




* 




* 


X 


*• 


— 


* 


18349 


* 


33691 


* 


33691 * 


* 


X 


* 


X 


* 


X 


* 


X 


* 




** 


... 


* 


... 


* 


13136 


* 


30974 * 


* 




* 


X 


* 


X 


* 


X 


* 




*• 


... 


* 


5454 


* 


21687 


* 


31825 * 


* 


X 


* 




* 


X 


* 


X 


* 




** 


... 


* 


3610 


* 


19852 


* 


31183 * 


* 




* 




* 


X 


* 


X 


* 




** 


... 


* 


11921 


* 


27450 


* 


32034 * 


* 


X 


* 


X 


* 




* 


X 


* 




** 


... 


* 


... 


* 


18482 


* 


31280 * 


* 




* 


X 


* 




* 


X 


* 




** 


... 


* 


10531 


* 


26764 


* 


32131 * 


* 


X 


* 




4 




* 


X 


* 




*• 


— - 


* 


8645 


* 


24929 


* 


31489 * 


* 




* 




* 




* 


X 


* 




** 


... 


* 


16998 


* 


3234C 


* 


32340 * 


* 


X 


* 


X 


* 


X 


• 




* 




** 


... 


* 


7739 


* 


23801 


* 


33534 * 


* 




* 


X 


* 


X 


* 




• 




** 


... 


* 


15937 


* 


298C1 


* 


34385 * 


* 


X 


* 




* 


X 


* 




* 




** 


... 


* 


1424C 


* 


29159 


* 


33743 * 


* 




* 




* 


X 


* 




* 




** 


... 


* 


22653 


* 


34594 


* 


34594 * 


* 


X 


* 


X 


* 




* 




* 




*• 


... 


* 


12850 


* 


28878 


* 


33840 * 


* 




* 


X 


* 




* 




* 




** 


... 


* 


21283 


* 


34691 


* 


34691 * 


* 


X 


* 




* 




* 




* 




** 


— 


* 


19317 


* 


34049 


* 


34049 * 



********************************************************************* 



■• INSUFFICIENT BUFFER SPACE 



LINK6EN COMPLETED 



Figure 4-3. Sample Buffer Space Report for a CCP Run 
(partial report only) 



DIR, OUTPUT DIRECTIVES REPORT 

This report generates a copy of all the directives that 
Autolink generates for MPLINK. The directives are in the 
order in which they appear in the MPLINK input file. An 
output directives report is shown in appendix H as the 
MPLINK input directive file. 



MAP, MEMORY ADDRESS MAP REPORT 

This report produces two listings: 

• One listing gives the names and starting addresses 
of all modules in ascending address order. 

■ The other listing gives the names and starting 
addresses of all modules in alphabetical module 
name order. 

This report is similar to the maps produced by MPLINK, 
and is a convenience when the user does not plan to run 
MPLINK immediately following Autolink. A sample 
report is shown in figure 4-4. 



INFO. INPUT DIRECTIVES REPORT 

This report lists input directives and application lengths. 
Only those directives that follow the RPT=INFO directive 
in the input file are included in this report. A sample 
report is shown in appendix G. 

SPECIAL CONSIDERATIONS 
FOR USING AUTOLINK 

This subsection discusses four aspects of using Autolink: 

• The interrelationship of the APPL, DEF, and MOD 
directives 

• Requirements imposed on modules used by two or 
more applications 

• A method for minimizing the number of MPLINK 
directives that are generated 

• Autolink's method of locating modules in a build 
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CYBER MINI CROSS SYSTEM - LINK fOITOR - 
NODULE HEflORY MAP - SORTED BY MODULE AOORESS 



*NQDUL=* 


*AOD«E5S* 


♦NODULE* 


♦ADDRESS* 


♦MODULE* 


♦ADDRESS* 


♦NODULE* 


♦ADDRESS* 


7EPOX 


OCC3 


PNLNBA 


4148 


PBSETP 


5393 


PN2DLT 


5F8D 


"BIMTR 


0101 


PNSGAT 


4195 


P8CLRP 


53B5 


PN2FUL 


6005 


JUNPS 


01*0 


PNC C FI 


42AE 


PBCOKP 


53C1 


PNROUT 


6051 


ACDRCS 


01?J 


PNCECN 


4446 


PBRPPG 


53E0 


PNOIftA 


60AF 


SLOBLS 


00 A 


PMSTOR 


444E 


PBPSWI 


53F1 


PN0I*D 


6134 


ISPOLO 


iF^B 


PTAFOU 


4470 


P9PUTP 


54 OB 


PNQUEU 


617E 


P8CAI L 


IFrO 


PTARFT 


44C9 


PBGETP 


5422 


PIMOEQU 


6104 


<"HNOj 


1F93 


*4ASYI 


4414 


PBST»H 


5433 


PBFHAH 


62 35 


P3LN01 


1FC4 


ASYKSG 


47A8 


UNLOCK 


5446 


P9T0AH 


6320 


I'PAMA"; 


1FE0 


ASYLF* 


47fll 


QULCICK 


5455 


P1T0AH 


6387 


PNSMWL 


2000 


PTAPSP 


473E 


PBRTCD 


5466 


PBTOAO 


64 OF 


°NAVAI 


219 4 


AASCST 


4i3C 


OFMTRY 


5471 


PNNLFH 


6470 


?HZTK 


21P-7 


AAcBCD 


41FC 


QEXIT 


54 BC 


PTNSCA 


6494 


PNS*BA 


21CI 


AACAPL 


4?3C 


B'JFNAI 


54DA 


P8CLKI 


6514 


PNRVR5 


??17 


ATAPLA 


497C 


LISTSR 


5550 


PB100M 


652F 


PNTkCrt 


?'3 fl 


ABAPLA 


413: 


PBSTOP 


5578 


PBOELE 


65 3t 


PNOREL 


?.?7l 


AASTAP 


49? C 


PTTPIN 


5*3B 


"»8INSE 


6570 


PNGTCd 


£"»4 


AASBAO 


4»3C 


HooKsr 


5592 


P8UP0A 


66F3 


»NTC8S 


?»F'J 


ASTOAS 


4A7C 


P3LN04 


56*9 


PBTN*S 


6751 


"N^LTC 


'346 


AFSCOA 


4AFC 


P3LN07 


56A5 


P8TICK 


6818 


PN'CwA 


243? 


AEAPLA 


497C 


PBLNC<> 


56B1 


P8T00U 


66B3 


PNDISC 


m. * 


AAFAPl 


43FC 


PBLN10 


56B0 


PBTOSR 


68 DO 


PNS^TD 


^Hf 1 


ACAPLA 


4C3C 


P8LN11 


56C9 


OBTOOE 


69 56 


PNSMR 


2^?0 


A7T06° 


4C3C 


P9LN12 


56D5 


PBTINA 


69A2 


PNSM^T 


'566 


PBLNOf 


4CFC 


»3LN13 


56E1 


PB16AD 


69E9 


°NLLC 1 


'65: 


PTCTCH 


4034 


PBLN14 


56E0 


PBLC3T 


6AZ1 


PNLNCN 


27t2 


°T°ETO 


4065 


PBLN15 


5fcF9 


"8TIN0 


6305 


PfcTfLC 


>»2-< 


ptsvil 


436A 


PBNENB 


5705 


PBLLEN 


6B9F 


PNDfcL? 


?F7d 


PTSV2L 


4330 


PBLC8P 


5732 


PBLLRM 


6900 


PNENA9 


3077 


PTRTll 


4006 


PgMIN 


575F 


PNBMPS 


6C37 


PNjISA 


H19 


PT9T2L 


4D»F 


P3NAX 


577F 


PNCOIN 


6C59 


PNl INF; 


'iCA 


PT*EGL 


40A6 


PBSTRI 


579F 


PBCOIM 


6C3E 


»NT M LJ 


34A C 


PBTWLE 


4 = 36 


PBCOPY 


57E6 


PHCORV 


6CDE 


PN1LLS 


35C3 


PBOBLK 


4?4F 


PPPUTY 


587B 


PBSCLA 


7297 


PNLIST 


3644 


P801BL 


4F78 


PBOLTX 


5BCB 


PNHOLP 


72C6 


PN'NTt. 


37?E 


PTINII 


4F31 


PBPAGE 


59 2 B 


PTCLAS 


74A5 


°NLCP 


17 tO 


PTIVTC 


4£C2 


PBXFER 


5989 


P1T1SE 


7664 


PNSTAT 


"»7<J6 


P9SLJ 


4E0B 


PB1PAD 


59B0 


PTLNUX 


76S9 


PN1LNS 


3706 


PGOSTA 


4c? 2 


P9188I 


5A2A 


PBSWLE 


76C0 


PN2LNS 


3*fc£ 


PB*LIA 


5377 


PBieco 


5AD3 


PBIMTP 


76C3 


D NLNST 


391? 


FG5WIT 


5 IB 4 


PB8FAY 


5C05 


PBUPAB 


7604 


PN1TML 


3Sf 5 


PP-LNO? 


52C8 


PBADJU 


5C7C 


PBONAB 


76 07 


PNT^LS 


3AFA 


PBLN03 


52?7 


PM1SRC 


5060 


PBLOST 


76F5 


PNBROC 


3BFh 


PBLN08 


5306 


PN1GTP 


5DA4 


P3HDRB 


76FF 


PN1BR3 


30 62 


PBFILE 


5325 


PN1AD0 


5009 


P3PIP0 


7740 


PNOVLQ 


3E7C 


PBLMAS 


5150 


PN1DLT 


5E29 


PBIIPO 


7758 


PNFRCE 


3F9A 


PBOHAS 


535D 


PN1FUL 


5EBA 


PT3ACK 


779F 


9N0YLT 


3FC1 


PBSMAS 


536B 


PN2SRC 


5EB2 


PTBREA 


77ED 


s NOVLO 


4000 


PBBEXI 


5377 


PN2GTI 


5EDE 


PTSTRT 


78 4F 


PMPSTA 


4089 


PBAEXI 


5385 


PN2A00 


5F38 


PTSTOP 


7892 



Figure 4-4. Sample Memory Map Report for a CCP Run 



INTERRELATIONSHIP OF THE APPL, 
DEF, AND MOO DIRECTIVES 

APPL directives specify all the applications that can be 
used in a NPU build. 

DEF directives specify all the applications that are to be 
included in a given build. To specify a different build, it 
is necessary to change only the DEF directives in the 
input directives file. 

Each application used in a build must have at least one 
module defined for it by a MOD directive; that is, at least 
one MOD directive specifies that application in its APPL 
= appl parameter. If an application is not included in a 
given build (that is, it is not defined by a DEF directive), 
that application does not need to have any MOD directives 
specifying it. 



DUPLICATE MODULES 

When a module is used by two or more applications, that 
module's MOD directive must specify all the applications. 
Using the same MOD name in two MOD directives causes 
a fatal error. 

A module is loaded for one application only; it is not 
duplicated for other applications. If a module with a 
tophat is located on a page, the tophat (relocation vector) 
is retained. If a module with a relocation vector is 
located in a nonpaged area, the module name is included 
in the DELETED TOPHAT MODULE LIST, which is one of 
Autolink's informative messages. 
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MINIMIZING THE NUMBER OF OUTPUT DIRECTIVES 

Whenever possible, Autolink creates an output directive to 
MPLINK in the form *L,modi-modj. This statement 
directs MPLINK to start linking the module named modi 
following the previously linked module, and to continue 
linking consecutive modules as they appear on the input 
object code file until the module called modj is linked. 
This requires that both the Autolink and the Link utilities 
use the same input object code file. Otherwise, a nonfatal 
error occurs. 



AUTOLINK'S METHOD OF SELECTING 
A LOCATION FOR A MODULE 

Autolink uses the following algorithm to maximize the 
amount of buffer space: 

• Paged modules are assigned space first. 

• Next, modules with main memory addresses and 
their associated modules are assigned space. 

■ Next, modules that are to be reverse-loaded are 
assigned space starting at the upper end of 
assignable main memory (location FFFEig), or at 
the address specified. 

• The remaining applications are assigned space in 
the largest free area in main memory. 

• FILL modules are located in the main memory 
holes and in page holes. 

• The last application (which must be PIDTBL) is 
located at the end of the sequential applications. 

• Buffer space is computed. 

The specific steps used by Autolink in each of these 
phases are described below. 

Figure 4-5 shows this sequence. 



Phase 1, Assigning Space to Paged Modules 

First, Autolink locates modules assigned to a page by the 
MOD directive's P=P parameter. If an application is the 
only user of this module, that application is located on the 
same page. 

Next, any remaining applications with an NC parameter 
are assigned locations on free pages. Applications which 
are non-exclusive users of a P=P module are located on 
free or nonreserved pages. 

Then Autolink calculates the length of any applications 
which have not yet been located on a page. If an 
application will not fit on any one page, part of it is 
placed on the page with the largest assignable space. The 
rest of it is assigned to main memory. 

Finally, Autolink sorts the pageable filler modules (Mod 
parameters P=P and FILL) modules by length. Starting 
with the largest module, Autolink attempts to locate that 
module in the largest free space in paged memory. This 
process continues until all the modules are either located 
or put aside because paged space was not large enough to 
hold them. 



(START SPACeN 
ALLOCATION J 



ASSIGN 

APPLICATIONS 
TO PAGES 



I 



-PAGE ONE - 8196 WORD PAGE STARTING 
AT 2OO0, 6 

OTHER PAGES ARE 8196 WORDS LONG AND 
START AT 10000, 6 , 12O00, 6 , 14O00, 6 .. ..UP 
TO IE00O 16 (DEPENDING ON MEMORY SIZE) 



ASSIGN 
APPLICATIONS 
8ELOW FFFF-,6 
(NON PAGED) 



ASSIGN 
REVERSE 
LOADED 
MODULES 



I 



-USUALLY STARTS 
AT FFFE 16 



ALL OTHER 
APPL TO LARGEST 
OPEN AREA BELOW 
FFFF 16 



FILL MODULES 
TO HOLES IN 
MAIN MEMORY AND 
PAGED MEMORY 



LAST 

APPLICATION 

(PIDTBLI 



I 



- STARTS AT WORD FOLLOWING LAST 
WORD OF PREVIOUSLY LOADED 
SEQUENTIAL APPLICATION IN MAIN 
MEMORY 



ASSIGN 
BUFFERS 



f GNO J 



Figure 4-5. Autolink Sequence of Locating 
and Link Modules 



Phase 2. Assigning Space in Main Memory 

This main memory space assignment phase occurs after 
page space assignment is completed. 

Applications with specific addresses (ADDR = addr) are 
assigned space in the order in which they appear in the 
APPL directives. A module associated with two or more 
applications is located with the first application 
encountered, not in the order of the MOD directive's 
APPL parameter. Within an application, modules are 
located in the order in which they appear in the input 
directives file. 

A module with the MOD parameter FILL is not located 
during this phase. 

If a module overlaps into space already assigned to a 
module (ADDR parameter is specified) during this phase, a 
fatal error occurs. 
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Phase 3, Assigning Space for Reverse-Loaded Modules 



Phase 6, Assigning Space for the Last Application 



Reverse-loaded modules are specified by MOD parameter 
P=R. Space is assigned to these modules in the same 
order in which they are encountered in the input 
directives file. The ending address of the first module 
encountered is located at a fixed or a specified main 
memory address. The next module's ending address is 
assigned to the word preceding the previous 
reverse-loaded module's starting address. This process 
continues until all the re verse- located modules are given 
space in one contiguous group. 

The ending address given to the set of reverse- loaded 
modules is determined in one of two mutually exclusive 
ways: 

e The MOD directive for the first reverse-loaded 
module in the directives input file is given a 
specific address in the ADDR parameter 
(example: PIBUF2 is the first reverse loaded 
module; its directive specifies ADDR = $FFFE). 
This address is the ending address of the module 
rather than the starting address. 

e No address is specified for the first 
reverse-loaded module in the directives file. In 
this case, the highest assignable main memory 
address is used (FFFEig) as the ending address of 
the module. 

If one reverse-loaded module overlaps another (as could be 
the case if a reverse-loaded module is given an ADDR 
parameter), a fatal error occurs. 



Phase 4, Assigning Space to Sequence 
Applications in Main Memory 

This phase assigns space for all those modules belonging to 
applications specified in a DEF directive, but which (1) 
are not assigned addresses, (2) are not FILL modules, and 
(3) are not exclusively associated with the last application. 

The first application in the input directives file is assigned 
space starting at the beginning of the largest unassigned 
area in main memory. All the modules associated with 
that application are located contiguously in the order in 
which the MOD directives appeared in the input directives 
file. When the first application is finished, space is 
assigned for the next application in the same manner, 
starting at the next word in main memory. This process 
continues until all modules in all applications (except the 
last application, PIDTBL) are assigned space. 

At the end of this stage, a sequential set of applications 
fits into the area selected. During this phase, if any 
module overflows the end of that area, a fatal error 
occurs. 



Phase 5, Assigning Space for FILL Modules 

At this stage of the process only two types of module 
remain to be located: FILL modules (designated by the 
FILL parameter of the MOD directive) and modules that 
are exclusively associated with the last application. FILL 
modules are assigned space in main memory in any 
unassigned area large enough to accommodate them. If 
all the FILL modules cannot be located, a fatal error 
occurs. 



The only remaining modules are those exclusively 
associated with the last application, PIDTBL. Its module 
lengths are added to calculate a single application length. 
Its address is set to the word following the ending address 
of last forward-loaded module. 



AUTOLINK MESSAGES 

Two types of messages are generated during Autolink 
operations: 

• Certain nonfatal errors generate an informative 
message specifying events of interest to the user, 
but events which do not stop Autolink processing. 
These messages are copied to the listing file. 

• Fatal errors generate a fatal error message; it is 
copied to the fatal error file. A fatal error also 
generates informative messages that are copied to 
the listing file. 



INFORMATIVE MESSAGES 

Informative messages are copied to the output listing 
file. Such messages are preceded by the directive that 
was being processed when the error or processing step 
occurred. The general format of these messages in the 
listing file is: 

Directive 

Program scan pointer address 

Message text 

The informative and nonfatal error messages are listed in 
table B-3 of appendix B. The type of action that should be 
taken when the messages appear are also given in that 
table. 



FATAL ERRORS 

A fatal error generates the message FATAL ERROR for 
the fatal error file. Autolink processing stops except to 
prepare the diagnostic information that is copied to the 
output listing file. This consists of two parts: 

• Diagnostic comments 

• A message specifying the fatal error type. Most 
fatal error messages are concerned with a 
directive error. This type of error message is 
treated the same as an informative message: the 
fatal error message is preceded by the directive 
which was being processed when the error 
occurred. The general format of these fatal error 
messages in the listing file is: 

Directive 

Program scan pointer address 

Fatal error message 

The fatal error messages are given in table B-4 of 
appendix B. The type of action that should be taken when 
the messages appear is also given in that table. 
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LINK UTILITY 



INTRODUCTION 

The Link utility (MPLINK) uses an input directives file and 
an input object code file to generate two principal outputs 
(see figure 1-1): 

• A memory image load module file consisting of 
object code modules. The local file name (Ifn) for 
this file is ABSOLMP. The file's modules are 
located in memory image order; that is, they have 
the absolute addresses they would have if they 
loaded into an NPU. Initializable variables have 
the same values that they have on the object code 
input file. These variables are initialized later to 
selected values by the Edit utility. 

• A symbol table (lfn = SYMTAB) consisting of the 
module names and entry points. 

The Edit utility uses both these files plus its own input 
directives to generate an initialized version of the 
memory image load module file. This load module can 
then be used to generate the downline load files used by 
the host to load a CCP or CCI system into an NPU. 

If standard CCP installation procedures are used, this 
program is generated by the build procedures from the 
release tapes; its use is generally invisible to the system 
installer (see the NOS and NOS/BE Installation Handbooks). 



The MPLINK input directives file can be : 

• User-supplied 

• Generated by SCF procedures during a standard 
CCI installation 

■ Generated by Autolink procedures during a 
standard CCP installation 

The Link utility supplies special output listings including 
memory maps, symbol lists, input directives, and a 
hexadecimal listing of the memory image file. 



NPU ADDRESSING 

MPLINK assigns each module to an execution area in main 
memory, in extended memory, or in an overlay area of 
main memory. To uniquely address 128K (131,072) words, 
an 18-bit address is provided (only 17 bits of the address 
are used). However, when paging registers are used, an 
11-bit address will locate any word on a 2K (2048) word 
physical page. The remaining seven high-order bits are 
used to designate the logical page. Note that both CCP 
and CCI use an 8K (8196) word logical page. 

The NPU has two addressing modes: paged and absolute. 
In either mode, the operating system calculates a 16-bit 
address for each memory reference. 



In the absolute mode, the 16-bit value is the 
effective address in the range 0000 - FFFF^g. 

In the page address mode, the page registers are 
used to achieve an effective 18-bit memory 
address in the range 0000 - 3FFFF^6 (only the 
range OOOO-lFFFjg is used). 



PAGE ADDRESSING MODE 

In page address mode, the NPU memory is subdivided into 
physical pages, each of which is 2K words long. The 
location of a word within a page requires an 11 bit address 
(range 000 - 7FFj^) and is called the page displacement. 
Page displacement is the least significant bits of an NPU 
address. 

Each page is assigned a unique identification (range 00 - 
7Fig) called the page number. The page number uses the 
most significant bits of an NPU address. 

Page displacement taken together with page number gives 
an 18-bit addressing capability. 

During page addressing mode, a page number is associated 
with one of the 32 hardware paging registers (range 00 - 
lFig). This requires five bits of the address, and is 
handled by an MPLINK directive that associates the page 
numbers with the page registers. Page register selection 
(five bits) together with page displacement (11 bits) gives 
the normal 16 bits of memory address referencing. 

There are two sets of 32-page registers. Either set (0 or 
1) can be active at any one time. The set being used is 
selected by the executing program. Figure 5-1 correlates 
the 18-bit address to page register and page displacement. 

MPLINK assumes that all memory address specifications 
are in the page address mode. Therefore, each address 
specification has four distinct components: 

■ Page displacement 

• Page number 

• Page register 

• Page register set 



ABSOLUTE ADDRESSING MODE 

The Link and Edit utilities do not support an absolute 
addressing mode directly. However, the default mode 
causes MPLINK to generate a program that effectively is 
an absolute addressing mode. In this case, address 
assignments are made entirely from page register set 0. 

In default mode, the page register contents are the same 
as the page register numbers; that is, page register has a 
zero value, page register 1 has a 1 value, etc. The 
resulting address resolution provides the same addresses 
that would be generated if absolute addressing mode was 
used. 
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PAGE REGISTER POINTS TO A I _!i> 
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RFG 


PAG 
SET 


E 



REGISTER 


<* 







PAGE NUMBER 




1 


PAGE NUMBER 


J 


• 
• 

-1 






• 
• 
• 








PAGE NUMBER 





PAGE DISPLACEMENT 



PAGE REGISTER 



REG 


1 



SET 


1 






PAGE 


NUMBER 




PAGE 


NUMBER 



31 



PAGE NUMBER 



17 



< 



18-BIT EFFECTIVE ADDRESS 
10 



PAGE NUMBER 



PAGE DISPLACEMENT 



Figure 5-1. Page Register Selection 



SPECIFYING A MEMORY ADDRESS 

The memory address is specified in three parts: 



Number 
of Bits 

18 

5 

1 



Address Part 

An effective address consisting of a page 
number plus page displacement 
page register 
page register set 



Format of the address is: 

effective addresstpage register:register set 

Note that address parts are separated by colons. Each 
part is a numerical value in one of seven formats: 

• A decimal constant. This is preceded by a sign if 
necessary. Examples: 10, -734. 

■ A positive hexadecimal constant. This is preceded 
by a dollar sign ($). Examples: $2000, $4FAC. 

■ A linked module name 

• An entry point name 

• An overlay area name 

• A local variable name 

• An address function 

A previously linked module name with an explicit address 
assignment, a defined entry point name, a defined overlay 
area name, a defined local variable name, or an address 
function can be used as any part of the specified address. 
The effective address associated with any one of these 
names represents the numerical address value. 



Address Functions 

MPUNK provides five functions that can be used with an 
operand or an address expression to generate a part of an 
address. The functions are requested by means of 
keywords. If this method is used, specification must have 
the following format: 

/keyword (name) 

where name identifies a module, an entry point, or an 
overlay. The allowable keywords are: 

Keyword Value Returned by the Function 



PGDISP 

PGNUM 

PGREG 

PGSET 

OVID 



For example: 



11-bit page displacement 

7-bit page number 

5-bit page register 

1-bit page register set 

Last two characters of the overlay name 

in which the overlay module resides 



/PGNLMPNSMWL) 



returns the 7-bit number of the 
page used by the service module 
(PNSMWL) 



Address functions can be used only if the module, entry 
point, or overlay has been explicitly, named and the 
assignment of the address related to the name has 
preceded the reference. 

Examples of a full address specification are: 

• $13B75:$A:1 

The 18-bit effective address is composed of a 

page number = 27j6» and a page displacement of 

375 16- 

Page register 10 is to be used. 

Page register set 1 is to be used. 
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MODA:/PREG(MODB):l 

The 18-bit effective address is taken from the 

starting execution address of MODA. 

The page register where MODB is located is to be 

used. 

The page register set to be used is 1. 

$lA45:/PREG(MODA):/PGSET(MODB) 

The 18-bit effective address is composed of a 

page number (3), and a page displacement of 

045 16 . 

The page register where MODA is located is to be 

used. 

The page register set where MODB is located is to 

be used. 



Abbreviating Address Specification 

It is not always necessary to specify the second (page 
register) and third (page register set) parts of the memory 
address. If only the first part of the address is specified 
(either as a constant or an address function), the page 
register is equal to the page number portion of the 
effective address (upper seven bits), and the page register 
set is assumed to be the same as in the previous memory 
address specification. For example: 

$421F:8:0 
$421F:8 
$421F::0 
$421F 

All specify the same address: the page displacement is 
21Fj5, the page number is 8, the page register is 8, and 
the page register set is 0. 

Addresses are specified similarly if an address function is 
used. For example: MODA is equivalent to 
MODA:PREG((MODA):PGSET(MODA). 



ADDRESS ASSIGNMENT 

MPLINK maintains an internal location counter for the 
four-component memory address. The location counter 
(which is used to assign space within the memory image 
file) is initially set to zero. The components are updated 
automatically as the memory image file is generated. 
Specifying a memory address within a link or overlay 
directive is the only method used by the Link or Edit 
utilities to explicitly assign an address. 

As 16-bit words of a module's object code are moved into 
the memory image load module file (possibly with address 
resolution), the words are assigned consecutive memory 
addresses. If assigning the next address causes a memory 
page overflow condition, the internal location counter is 
adjusted to the first word (displacement = 0) of the next 
consecutive page. At the same time, the page register 
value is incremented by one. 

Note that memory page overflow is not an error condition 
unless the resultant page register value is greater than 31, 
or the page number is greater than 127. 

Unless MPLINK is given a specific load address for linking 
a module, the memory address assigned to a module is the 
next available memory address held in the internal 
location counter. 



An area of memory which is designated as an overlay area 
can have several different module groupings for the area. 
Such a module grouping is called an overlay. On-line CCP 
or CC1 execution of these different groupings occurs at 
different times. 

Each overlay has a unique, two-letter identifier. If the 
user does not specify the identifier, MPLINK assigns the 
next alphabetic character in sequence (range AA through 
ZZ) when the next overlay is built. The binary equivalent 
of the identifier is returned to the user with each OVID 
keyword assignment. 

The first overlay module of an overlay group is assigned 
the memory address at the start of the overlay area. 
Subsequent overlay modules of the same group are 
assigned space directly following the previously linked 
overlay module. MPLINK assigns overlay modules in this 
fashion until the next *L directive with an explicitly 
declared address occurs (the *L directive declares the 
overlay name). The user must explicitly declare all 
overlays using this directive. 



MPLINK INPUTS 

The user must supply MPLINK with two input files: one 
file contains directives, the other file contains object 
code modules. The user has the option of supplying a 
library file in addition to, or instead of, the object code 
module file. The MPLINK procedural flow is shown in 
figure 5-2. Typical MPLINK use is given in the examples 
in appendix H. 



MPLINK DIRECTIVES FILE 

This file can be generated in one of three ways. 

• CCP: The simplest way is to use the Autolink 
utility. Autolink solves many of space assignment 
problems that the user would otherwise have to 
solve by repeated trials. 

• CCI: The installer uses the SCF procedures with 
the standard installation processes. 

• Either: The user can generate his own file of input 
directives using the MPLINK directives described 
later in this section. 

In all cases, the directive file is the first input file 
presented to MPLINK. 



MPLINK OBJECT CODE INPUT FILE 

The required input file contains the object code modules 
to be included in the build. If Autolink was used, the same 
object code file must be presented to Autolink and to 
MPLINK. 

These modules in this file were previous put in this form 
by a CYBER Cross assembler or compiler (macro- 
assember, microassember, or PASCAL compiler - see the 
appropriate CYBER Cross language reference manual). 
The format of this relocatable object code is given in 
appendix F. 

Optionally, in CCI, the input modules file can be a library 
file version of the modules in object code. This file was 
previously produced by MPLIB. The library file is always 
presented to MPLINK as the NEWLIB file. The library is 
used by MPLINK to resolve all unsatisfied external 
references. 
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•SAME OBJECT CODE FILE AS 
WAS USED FOR AUTOLINK INPUT. 




M-1087 



Figure 5-2. MPLINK Procedural Flow 



Note that any object code file must be rewound prior to 
delivery to MPUNK; MPLINK does not rewind the files 
automatically. 

MPLINK OUTPUT FILES 

Three types of output files are produced by MPLINK. 

• memory image load module file (ABSOLMP) 
■ system table (SYSTAB) 

• listings 

MEMORY IMAGE LOAD MODULE FILE (ABSOLMP) 

The file contains all the object code modules specified by 
the MPLINK directives. In this absolute memory image 
file: 



All modules are assigned to a specific execution 
address 

All modules are assigned to a selected page 
register 

All relocatable addresses are converted to 
absolute addresses 

All external references are resolved 

All overlay modules are grouped in specified 
overlay areas 



SYMBOL TABLE (SYMTAB) FILE 

The SYMTAB file contains the entire set of entry symbols 
and module names defined by MPLINK. Each entry has a 
value (either a memory address, a displacement, or a 
constant), a field start location, and a field length. 

MPLINK LISTINGS 

MPLINK automatically produces five listings; a sixth 
listing can be produced at the user's option. The listinqs 
are: 

• A copy of the input directives file. 

• A module memory map sorted by module name. A 
sample partial listing is shown in figure 5-3. 

■ A module memory map sorted by module address. 

■ An entry symbol list sorted by entry name. A 
sample partial listing is shown in figure 5-4. 

• An entry symbol list sorted by address. 

• A hexadecimal list of the memory image load file 
(optional). This is requested by the *DMP 
directive. 
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CYBER MINI CROSS SYSTEM r LINK EDITOR - 
MODULE MEMORY HAP - SORTED BY MODULE NAME 



♦10DULE* 


♦AODRESS* 


♦MODULE* 


♦ADDRESS* 


♦MODULE* 


♦ADDRESS* 


♦MODULE* 


♦ADDRESS* 


AACAPL 


49 3C ' 


PBCOMP 


53C1 


PBPOPO 


7 A 70 


PINIT 


FBAF 


AAEAPL 


4BFC 


PBCOPY 


57EE 


PBPROP 


7A55 


PINWIN 


F724 


AAEBCD 


48FC 


PBDELE 


653E 


pbpsmi 


53F1 


PIPROT 


F67F 


AASBAP 


4A3C 


PBDLTX 


58C8 


P8PUTP 


540B 


PISIZC 


F6D5 


AASCST 


48 BC 


PBDNAB 


760 7 


PBPUTY 


5678 


PITMRS 


FE05 


AASTAP 


49FC 


PBFILE 


5325 


PBOBLK 


4E4F 


PIWLtN 


FBF8 


ABAPLA 


49BC 


PBFMAO 


7F84 


P301BL 


4t78 


PLCBIN 


1605CS205C 


ACAPLA 


4C3C 


PBFMAH 


62S5 


P8RDPG 


53E0 


PLIOST 


162C0J22CO 


ADDKFS 


OlbO 


PBFRNC 


7A9 4 


PBRTCO 


5466 


PLIPML 


1621A:221A 


AEAPLA 


*B7C ' 


PBGETP 


5422 


PBSCLA 


7297 


PLIPTC 


16006:2006 


AFBCDA 


4AFC 


PRHALT 


8096 


PBSETP 


5393 


PLIP 


162F2S22F2 


ASCE26 


153^C:339C 


PBHDRB 


76FF 


PBSLJ 


4EDB 


PLREAD 


16000:2000 


ASCF?^ 


1535C:335C 


PBIIPO 


7758 


PBSMAS 


536B 


PLTKOP 


16000:2000 


ASTDAS 


4A7C 


PBFLL 


803F 


PBSTOP 


5578 


PNCO*V 


6CDE 


ASYFRR 


11729:3729 


PBINSE 


6570 


PBSTPN 


5433 


PMCOIN 


6C59 


ASYLFM 


47B1 


PBINTP 


76: B 


PBSTRI 


579F 


PMMLFH 


6470 


ASYMS3 


47A« 


PBINTR 


0100 


PBSULE 


76C0 


PMT1SE 


7664 


ATAPLA 


497C 


PBIOPO 


7956 


PBTICK 


681B 


PMWOLP 


72C6 


A12UE8 


153!)C:33DC 


PBLCBP 


5732 


PBTIHA 


69A2 


PNAWAI 


2198 


A7T06P 


4C8C 


PBLC8T 


6A21 


PBTIHO 


6B05 


PNBMPS 


6C37 


BEGINX 


F671 


PBLLEN 


6B3F 


PBTMRS 


67?1 


PNBRDC 


3BFE 


3UFMAI 


540A 


PBLLRM 


6 BOO 


P8TOA0 


640F 


PNCECN 


4448 


CLEANU 


1622l:?2?l 


P6LMAS 


5350 


PBTOAH 


6320 


PNCEFI 


42AE 


tBC»12 


1551CS3&1C 


PBLMKD 


7C01 


PBTODE 


6956 


PNCNTL 


372E 


E26ASC 


15490:3*90 


PBLNKU 


73A5 


PBrnou 


68B3 


PNCOMF 


15902:3902 


E29ASC 


1541C:341C 


PBLNOO 


1F9B 


PBTOSR 


680D 


PNDELE 


2F7D 


FCSRC8 


155-<C:*59C 


PBLN01 


1FC4 


PBTWLE 


4E36 


PNOEOU 


61D4 


SLOBLS 


C0A3 


PBLNO? 


52C8 


PBUPAB 


76D4 


PNDIRA 


60AF 


HASPMS 


8-56E 


PBLN03 


52E7 


PBUPDA 


66F3 


»NDIRD 


6134 


HSPTC3 


155BEi35BE 


PBLN04 


5699 


PBXFER' 


5988 


PNDISA 


3118 


HSR4IP 


S?CA 


PBLN06 


4CFC 


PB1O0M 


'652F 


PNOISC 


2458 


HSR^rr 


14F6BS2F6B 


PBLN07 


56A5 


PB16AD 


69E9 


PNDLTC 


2346 


HSR4TP 


150F4:30F4 


PBLNOB 


5306 


PB18AD 


59BD 


PNENAB 


3077 


IC 


16010:2010 


PBLN09 


5631 


PB18BI 


5A2A 


PNFRCE 


3F9A 


IS POLO 


1F5B 


PBLN10 


5630 


P318C0 


5AD8 


PNGTCB 


2294 


JUMPS 


0140 


PBLN11 


56C9 


PGOSTA 


4EE2 


PNLCR 


3760 


LIPSMA 


848C 


PBLN12 


5605 


PGHALT 


17D47J3D47 


PNLINE 


32CA 


LISTSR 


5550 


PBLN13 


56E1 


PGIVTC 


15E5CI3E5C 


PNLLCN 


265C 


MAINS 


F659 


PBLN14 


56ED 


PGSUIT 


5184 


PNLLIN 


7ADA 


MOD MS T 


55B? 


PBLN15 


56F9 


PIAPPS 


FC77 


PNLLLI 


7E66 


PBADJU 


5C7C 


PBLOAD 


804 5 


PI8UF1 


FB22 


PNLLLO 


7ECB 


PBAEXI 


5385 


PBLOST 


76F5 


PIBUF2 


FF98 


PNLLRC 


7DEE 


"BAMAS 


1FE0 


PBNAX 


577F 


PIDTBL 


868F 


PNLLRE 


70 39 


PBBEXI 


5377 


PBMEHB 


5705 


PIFR1 


F99A 


PNLLSN 


7058 


PBSFAV 


5C05 


P8HIN 


575F 


PIGETA 


F8A4 


PNLLST 


3644 


PBCALL 


IF8D 


PBMLIA 


5077 


PIINIT 


FC37 


PHLLTC 


7F0C 


PBCLKI 


6514 


PBHDN 


SOBS 


PTLCBS 


F849 


PNLNBA 


4148 


PBCLRP 


53B5 


PBONAS 


5350 


PILINI 


FD63 


PNLNCN 


27E2 


P8CLR 


801D 


PBPAGE 


592 B 


PILP1T 


F6E8 


PMLNST 


391E 


PSCOIN 


6CBE 


PBPIPO 


7740 


PIMLIA 


FE97 


PNOVLO 


4000 



Figure 5-3. Sample MPLINK (Partial) Memory Map Sorted by Module Name 



EXECUTING MPLINK 

MPLINK is executed by attaching the MPLINK permanent 
file (local file name is MPLINK), and then executing the 
file name call statement MPLINK. 

Three optional parameters are available with the MPLINK 
file name call statement: 

MPLINK(D=infile,R=outfile,CSET=cset) 

where D is the logical file which presents the input 
directives to MPLINK. Default is INPUT. R is the logical 
file that receives the listings. Default is OUTPUT. CSET 
is the host display code set to be used. CSET = 63 selects 
the CDC 63-character display code set; this is the default 
value. CSET = 64 selects the CDC 64-character display 
code set. 



Appendix H gives examples of executing MPLINK. 



MPLINK DIRECTIVES 

All MPLINK processing is controlled by the MPLINK 
directives entered in the input directives file. The 
general format of a directive is: 

*dirname, 

paraml,...,parami [paramj...paramn1 comment 



60471200 F 



5-5 



CYBER IMHl C»OSS SYSTEM. - LINK EDITOR - 



ENTRY STBBfJl LIST - SORTEO BY ENTRY NAME 



♦ ENTRY**' /A**AQ0P£SS/VAl'JE**8H S/L* 



*ENTRY**R/A**«ODRESS/VALUF**BIT S/l* 



+ ENTRY**R/A**AO0*ESS/»-ALUE**8IT S/L* 



AACAPL 


P 


4°?C 


AACDAD 


A 


oroo 


AACDPT 


A 


900 


AACDRR 


R 


4**C 


AAEAPL 


9 


4BFC 


AAiiPCO 


c 


«8FC 


AANR£» 


A 


0007 


AAOUTP 


A 


P003 


AARFAP 


A 


0004 


AASoAP 


K 


4»3C 


AASTAP 


X 


4^CC 


A3API A 


C 


493C 


ATAPL 


K 


i;* c f>i3»>e» 


ACA&TO 


A 


3C79 


ACAUTO 


A 


"JOl 


ACCAPL 


A 


0004 


ACCASc 


P 


] ltrt7:3MJ7 


ACCGPK 


^ 


0001 


AC3EL* 


A 


oco? 


ACEAPt 


< 


coo? 


AC r 8CD 


A 


oroi 


AC C IL 


A 


oo:o 


AC=PL 


A 


0001 


ACKMSG 


P 


H ^QC 


JCKPT» 


(• 


nfri 


ACLIH? 


A 


DOC" 


ACLIK1 


.•, 


OAOO 


AC811 


A 


0001 


AC°fl08 


A 


0*" V 


ACCLR 


I 


•IvK 


ACPF-VE 


A 


■>ooo 


ACPICS 


A 


3t">0 


acpid* 


A 


"r*5 


ACPIRI 


P 


icoa 


scPoei 


A 


305H 


ACOCHA 


A 


0O6C 


ACPONS 


A 


QCAd 


ACPRMA 


A 


OCIC 


ACRIIT 


A 


OOOA 


AflORES 


R 


0150 


AODRLC 


P 


OlbP 


ADDPSU 


P 


0160 


ADEAOT 


A 


i?ai4 


ADSTl 


A 


0001 


AOST2 


A 


0302 


AEABLS 


P 


474A 


AEAPL 


P 


11709:3709 


AEASCI 


P 


46A7 


AEATTN 


R 


4769 


AFATT1 


R 


4775 



A'FAUTl 


R 


4648 


AEAUT2 


R 


464E 


AFAUT.l 


R 


4654 


AESLS 


R 


4584 


AFCHR1 


R 


4660 


AECIN1 


R 


46DA 


AECIN2 


P 


46DC 


AECIN3 


P 


46E7 


AFCU4 


P 


46E9 


AECKKO 


R 


45A8 


AFC3D1 


R 


4SC0 


A=C0J2 


R 


. 46 AO 


AECS = 


R 


11607:3607 


AECSLt 


P 


475F 


AFC5L1 


P 


477A 


AtCSL? 


R 


477C 


A" INI 


R 


46F5 


Ac - FIN? 


R 


46F7 


AEETN3 


P 


4702 


AEFIN4 


e 


4704 


A£FU 


R 


45C5 


AEELTl 


P 


45CF 


Sti=LT 3 


P 


45E0 


AEE>L 


R 


45F1 


A£f »T1 


P 


45F9 


AEESLl 


R 


4780 


AEt5L2 


s 


4782 


AEIN'T 


R 


4583 


AtlNl 


R 


458C 


JtKlH 


R 


455F 


AESED1 


P 


473C 


AESLL 


R 


4570 


AES110 


R 


465B 


AES150 


R 


4668 


AES151 


R 


4662 


AES30 


R 


4674 


AES301 


R 


467J 


AEX8LS 


R 


463? 


A6X0LN 


R 


463A 


AEXDTA 


R 


462A 


AEXPTO 


R 


462F 


AEXSOI 


R 


4604 


AF4XJL 


R 


47A7 


AE4XIN 


R 


4792 


AIOLS T 


A 


0003 


AI0L= 


A 


0001 


AINPLB 


A 


OOOE 


AINPSB 


A 


0000 


AISPT1 


R 


4405 


AISPT6 


R 


452A 



AISP4C 


R 


4512 




AISP4E 


R 


44FA 




ALARM 


A 


0001 




ALARM? 


A 


0002 




ALARM3 


A 


0003 




ALCAPL 


R 


4C7C 




AlCCKA 


R 


4ABC 




ALEAPL 


R 


4B3C 




ALE8C0 


R 


4B3C 




ASASCI 


A 


0022 




ASAUTO 


A 


001B 




ASCF26 


R 


1539C:339C 




ASCE29 


R 


15350335C 




ASCINT 


R 


176C 




ASDISC 


A 


0003 




ASSLL 


A 


0004 




ASSCL 


A 


0031 




ASXPT 


A 


0002 




ASXiOI 


A 


0095 




ASYNCE 


R 


153A 




AS2741 


A 


0020 




ATAPLA 


R 


497C 




A TELL 


A 


0000 


FI7 


ATEPL 


A 


0000 


7:7 


ATP0I2 


R 


1131 B< 3318 




AT»OIb 


R 


1133FI333F 




AT°DI6 


R 


1136313363 




ATPDI8 


R 


11387:3387 




ATPPR1 


R 


11203:3203 




ATPPR4 


R 


112F2:32F2 




AIJCAPL 


R 


4C3C 




AUCPRA 


R 


4A7C 




AUEAPL 


R 


4B7C 




AUEBCO 


R 


4 AFC 




AVASCE 


R 


11729:3729 




AVASCP 


R 


1E50 




AVB7T0 


R 


1E74 




AVCNTR 


R 


1E3D 




AVCORE 


R 


1173A:373A 




AVCPRR 


R 


1E5E 




AVCRLF 


R 


1E52 




AVCRNS 


R 


1E50 




AVEBCO 


R 


IESF 




AVEBCE 


R 


1174AJ374A 




AVEOLS 


R 


1E29 




AVEOLT 


R 


1E20 




AVEOTN 


R 


47AB 




AVEOTP 


R 


1ES8 




AVIMTA 


R 


1E60 




AVIS4C 


R 


1E54 





ENTRY: Name of the entry symbol. It is up to six letters and numbers long. If a local entry, the slash (/) is omitted. 
R/A: Entry type; R-relocataHe, A^absolute, L*local. 

ADDRESS/VALUE: Address of the entry or its value. Addresses are a displacement from the first word of the file. If address is 64K (65,536) or 
,™' tTue • <Mre "» »PPea™- If address is above 64K, t»o addresses appear as shown: true:paged. For example 10000:2000 has a true address of 
10000^ and a page address of 2000[g. 

BIT S/L: Field start position/field length. Both of this values are given in bits. For start position, bit 15 is the leftmost bit. bit is 
the rightmost. Both start and length have a range 0-Fj o . 



Figure 5-4. Sample MPUNK Memory Map Sorted by Entry Name (Partial) 
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where An * indicates the beginning of a MPLINK 
directive, dirname is the name of the directive, paraml 
is a parameter. The first parameter is separated from the 
directive name by a comma. Additional parameters are 
separated from one another by commas. Some parameters 
are optional; optional parameters are enclosed in brackets 
,param . Parameter types are discussed below. Specific 
parameters are defined in the descriptions of individual 
directives. A period (.) terminates the command portion 
of the MPLINK directive. Comments start after the 
period and include all characters until the * which starts 
the next directive. 

An example of an MPLINK input directives file is given in 
appendix H. 



SUMMARY OF MPLINK DIRECTIVES 

Table 5-1 summarizes the MPLINK directives. 

MPLINK DIRECTIVE PARAMETERS 

There are three general types of paramters: 

• A name; it can be the the name of: 

a module 

an entry point in a module 

a synonym equating an entry point to an 

external 

the system being built 

an overlay area 

a local variable 

• An overlay identification 
■ A memory address 

MPLINK Directive Parameter Names 

A parameter name must begin with a letter. It can 
contain any number of following letters or numbers; 
however, only the first six characters are used by 
MPLINK. Therefore, all unique names must differ in their 
first six characters. Identical names lead to an MPLINK 
error. 

For the purposes of parameter names, the dollar sign ($) is 
considered to be a number. 



MPLINK Directive Overlay Identifier Parameter 

An overlay identifier always consists of two letters. If an 
identifier is not assigned in a directive statement, 
MPLINK generates its own overlay identifiers. 



MPLINK Memory Address Parameters 

The allowable forms of memory addressing were discussed 
earlier in this section. 



TABLE 5-1. SUMMARY OF MPLINK DIRECTIVES 



Name 


Function 


*CB 


Defines the upper boundary for 
linking programs . 


*COM 


Defines the blank common area used by 
macroassembler modules. 


*COR 


Defines the size of the combined main 
and extended NPU memories. 


*DAT 


Defines a common data area for PASCAL 
global variables . 


*DMP 


Produces the hexadecimal listing of 
the memory image load file. 


*DSTR 


Defines a stack area to be used for 
PASCAL reentrant/recursive procedures . 


*DVAR 


Defines a dynamic variable area for 
use with PASCAL variables. 


*END 


Last statement of the input 
directives file; ends the file. 


*EKT 


Associates a memory address with an 
entry point name. 


*L 


Links one or more modules, or links 
all the unlinked modules on a library 
file. 


*LIB 


Defines the library file used to 
resolve unsatisfied externals. 


*LL 


Specifies a lower limit memory 
address; modules cannot be located - 
below this address. 


*OVLY 


Identifies and establishes the limits 




of an overlay area. 


*RL 


Links reverse-loaded modules, with 
the module ending address specified 
in the directive. 


*SYH 


Equates an arbitrary name with an 
entry point name or a defined module 
name • 


*SYSID 


Specifies the name for the build. 


*DL 


Specifies an upper limit memory 
address; modules cannot be located 
above this address. 


*VE 


Assigns a variable expression value 

to a local variable. 1 



*L, SPECIFIES MODULES TO BE LINKED 

This directive links modules. The standard form of the 
Link directive is: 

*L,mod,addr. 



This causes MPLINK to locate object code module, mod, 
at starting address, addr. As it is located, other linking 
operations also occur: addresses are absolutized and 
externals are resolved. 
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There are five alternate ways of writing a Link directive: 

• *L,mod. 

Links the object code module (mod) starting at the 
word following the last word of the module most 
recently linked by MPLINK. Note that if trailing 
parameters are omitted, their delimiting commas 
can also be omitted. 

• *L„addr. 

Links all object code modules in the object code 
input file except those which are expressly linked 
by other *L directives. The modules are linked in 
the order in which they occur on the input object 
code file. The first module encountered starts 
linking at the specified address (addr). Note that 
the delimiting commas for the omitted mod 
parameter must be retained. 

• *L,modl-mod2,addr. 

Links all the modules starting with modi 
extending through mod2 on the object code input 
file, modi is located at the specified address. 
The other modules are located in order following 
that module. If either modi or mod2 cannot be 
located, an error occurs. 

• *L,modl-mod2. 

Same as the previous form, except modi is 
located at the address following the last word of 
the module previously linked. 

• »L. 

Links all object code modules in the input object 
code file except those which are expressly linked 
by other linking (*L,parameters, or *RL) 
directives. The modules are linked in the order in 
which they occur on the input object code file. 
The first module encountered starts at the word 
following the last word of the module most 
recently linked. 



•RL, SPECIFIES MODULES TO BE REVERSE LINKED 

The reverse linking directive locates a module so that the 
last word of the module is placed in the specified address. 
There are two alternate forms for the directive: 

• *RL,mod,addr. 

Links the module so that the last word is placed in 
addr. 

• *RL,modl-mod2,addr. 

Links a series of modules on the object code input 
file, starting with modi and extending through 
mod2. The last word of mod2 is located at addr. 
The module ahead of mod2 is linked next, with its 
last word immediately preceding the first word of 
mnd2. Other modules are linked similarly until all 
modules in the sequence (including modi) are 
linked. If either modi or mod2 cannot be found on 
the object code input file, an error occurs. 

*CB, DEFINES LINKING BOUNDARY 

This boundary directive prohibits linking programs above 
the specified address. Format of the directive is: 



*CB,addr. 

More than one *CB directive can be used in the directives 
file. If a second (or subsequent) *CB,addr is used, the 
second address becomes the new boundary value. If a 
*CB,0 directive is used, the boundary is removed. 

Programs that are prevented from being linked by the 
*CB,addr directive are subsequently linked by the link all 
(*L) directive unless (1) a *L has already been used or (2) 
there is no *L directive in the input directives file. In 
either of these cases, the unlinked modules are linked 
following the last program linking. 



*LL, DEFINES A LOWER LIMIT 
FOR LINKED MODULES 

This directive prohibits any module from being located 
below a given address in memory. If a module's starting 
address is less than the specified address, processing is 
halted and a fatal error message is generated. Format of 
the directive is: 

*LL,addr. 

Since *LL is positional (that is it applies only to linking 
directives that follow it in the directives file), more than 
one *LL directive can be included in the file. In this case, 
if *LL,addr2 follows *LL,addrl, the specified lower 
threshold is changed to addr2 for the remaining 
directives. To cancel a lower limit, the user enters the 
directive: 

*LL,0. 



*UL, DEFINES AN UPPER LIMIT 
FOR LINKED MODULES 

This directive prohibits any part of any module from being 
located above a given address in memory. If a module's 
ending address is greater than the specified address, 
processing is halted and a fatal error message is 
generated. Format of the directive is: 

*UL,addr. 

Since *UL is positional (that is it applies only to linking 
directives that follow it in the directives file), more than 
one *UL directive can be included in the file. In this case, 
if *UL,addr2 follows *UL,addrl, the specified upper limit 
is changed to addr 2 for the remaining directives. To 
cancel an upper limit, the user enters the directive: 

*UL,0. 



•SYSID. IDENTIFIES THE SYSTEM LOAD FILE 

This directive establishes a user supplied name for the 
load file. The system name and the optional text are 
placed in the memory resident header record of the load 
file. 

Format of the directive is: 

*SYSID,name[,text]. 

If the SYSID is not specified in a directive, the load file 
will not have a memory resident header record. In such a 
case, if a *L directive includes a module with the name 
LOADER, that module is placed at the head of the load 
file. 
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The optional text is any string of letters or numbers up to 
a total of 48 characters. 



•OVLY, SPECIFIES OVERLAY AREAS AND 
THE MODULES IN AN OVERLAY 

This directive has two purposes: 

• It defines the limits of an overlay area. 

• It specifies the modules that are to be a part of 
the overlay. An overlay consists of all modules 
defined by *L directives which follow one overlay 
directive and which precede the next overlay 
directive or the *END directive. 

Format of the *OVLY directive is: 

*OVLY,name,ovlyid,addrb,addre. 

where name is the overlay name (normally six letters or 
numbers). Note that the overlay name has the attributes 
of a defined entry point, ovlyid is the two-letter overlay 
identifier, addrb is the beginning address of the overlay 
area; and addre is the ending address of the overlay area. 

In using the *OVLY directive, the user should observe 
these rules: 

• A memory image load module file can have no 
more than ten overlay areas. 

• An *!_ directive which specifies the overlay area 
name as its starting address designates its first 
module as the start of that overlay. 

• Overlay areas cannot overlap. 



•ENT. DEFINES ENTRY POINTS 

This directive assigns a four-component memory address 
to a user-assigned name. The name is used to resolve 
like-named external references. The name must not be 
the same as an entry point in an already linked module. 

Format of the directive is: 

*ENT,name,addr. 

*SYN. DEFINES EXTERNAL SYNONYMS 

This directive equates an arbitrary name to a declared 
entry point name or defined module name. The equated 
name is to be used for resolving external references. 

Format of the directive is: 

*SYN,namel,name2. 

where namel is the name of a declared entry point or a 
defined module; and name2 is the name to be associate 
with namel. At every occurence of namel in the object 
code, name2 is substituted. 



•COR, DEFINES NPU MEMORY SIZE 

This directive defines the size of the NPU memory for 
which the load file is being generated. Format of the 
directive is: 



*COR,addr. 

where addr specifies one of the four legal CCP or CCI 
memory sizes. These are: 



$FFFF - 
$13FFF - 
$17FFF - 
$1FFFF - 



65,536 words 
81,920 words 
93,302 words 
131,072 words 



If addr is omitted, a default value of $FFFF is used. This 
is equivalent to an address specification of $FFFF:$1F:0; 
that is, FFFFig is the last address of memory, memory 
page 31 holds that address, and address register set is 
used for that range of addresses. 



•LIB, SPECIFIES LIBRARY FILE 

This directive specifies the library file which MPLINK 
uses to resolve unsatisfied externals during the linking 
process. Format of the directive is: 

«LIB. 

The library file is always presented to MPLINK with the 
local file name of NEWLIB. 



•VE, EQUATES A VARIABLE TO AN EXPRESSION 

This directive assigns the value of the specified expression 
to the named variable. Format of the directive is: 

*VE,nam:=exp. 

where nam creates a local variable of that name, exp can 
have any of the following formats: 

naml 

constant 

naml+constant 

naml+nam2 

naml-constant 

naml-nam2 

naml and nam 2 can be local variables or entry points 
which are absolute, or have been previously absolutized. 



•DSTK, ALLOCATES A STACK AREA FOR 
RECURSIVE/REENTRANT PASCAL PROGRAMS 

This directive allocates the area that is used by all 
reentrant and recursive PASCAL programs to save 
processing parameters when a call is made to a program 
which has not completely finished processing. Format of 
the directive is: 

*DSTK,addrb,addre. 

where addrb is the starting address of the area and addre 
is the ending address. 

The programmer can choose a starting address in any part 
of main memory that is not be used for other purposes 
(buffers, programs, globals, or other reserved areas). 
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•DVAR, ALLOCATES A DYNAMIC VARIABLE AREA 
FOR PASCAL PROGRAMS 

This directive allocates the dynamic variable area used by 
all PASCAL programs. The area is accessed by the 
PASCAL standard procedure NEW. NEW is a variable 
space allocation routine; it automatically allocates space 
for a variable based on the type of variable (see the 
CYBER Cross PASCAL Compiler Reference Manual). 

Format of the directive is: 

*DVAR,addrb,addre. 

where addrb is the beginning address of the area and addre 
is the ending address. 

The programmer can choose a starting address in any part 
of main memory that is not be used for other purposes 
(buffers, programs, globals, or other reserved areas). 



•COM, DEFINES A BLANK COMMON AREA 
FOR MACROASSEMBLER PROGRAMS 

This directive allocates a blank common area that is 
referenced by macroassembler modules. Format of the 
directive is: 

*COM,addrb,addre. 

where addrb is the starting address of the area and addre 
is the ending address. 



The programmer can choose a starting address in any part 
of main memory that is not be used for other purposes 
(buffers, programs, globals, or other reserved areas). 



PASCAL global variables are defined in an object code 
module named GLOBL$. The appearance of GLOBL$ in an 
*L directive takes precedence over a *DAT directive. 



•DMP. GENERATES THE MEMORY IMAGE LOAD 
MODULE FILE HEXADECIMAL LISTING 

This directive causes MPLINK to generate an output file 
consisting of a hexadecimal dump of the memory image 
load module file. The listing is sent to the file named 
OUTPUT. Format of the directive is: 

*DMP. 



•END, LAST MPLINK DIRECTIVE 

This directive must end the MPLINK input directives file. 
It also specifies the address of the first instruction to be 
executed after the load file is downline-loaded into the 
NPU. Format of the directive is: 

*END,addr. 

where addr is a hexadecimal number or an entry point 
name. Default for address is location 0. 



•DAT, DEFINES THE LABELED COMMON AREA 

This directive defines the labeled common area. PASCAL 
global variables are assigned to this area, and 
macroassembler programs can reference this area. 
Format of the directive is: 

*DAT,addrb,addre. 

where addrb is the starting address of the area and addre 
is the ending address. 



MPLINK ERROR MESSAGES 

If an error occurs during an MPLINK run, an error 
message is delivered to the output file. The messages are 
preceded by a leading-up arrow. If the error is a 
recognized syntax error, the up-arrow is followed by the 
character that was being processed when the error 
occurred. Table B-5 in appendix B lists the MPLINK error 
messages, and the action which the user should take in 
response to the message. 
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INTRODUCTION 

The Edit utility is used to initialize values in specified 
variables of the CCP or CCI absolutized modules. 

The MPEDIT utility requires three inputs: 

• The non- initialized memory image load module 
file (APSOLMP) output of MPLINK. This is the 
file to be initialized 

• The symbol table file (SYMTAB) output of 
MPLINK. This is used to locate the modules to be 
initialized. 

• The MPEDIT directives that control the 
initialization. This extensive file of directives is 
called an MPEDIT program throughout this 
section. The program is similar in format to a 
CYBER Cross PASCAL program; that is, it 
consists of a declaration/definition part followed 
by a group of executed statements. The user 
should be familiar with PASCAL compiler 
requirements and syntax (see the CYBER Cross 
PASCAL Compiler Reference Manual). 

o 
If a standard CCP or CCI build procedure is used, the 
MPEDIT program is available from the CCP or CCI 
program library. The program is generated by the build 
procedures from the release tapes (see figure 1-1). 

The output of MPEDIT is an initialized version of the 
memory image load module file. This file can be 
converted to a downline-load file for an NPU. 

MPEDIT also supplies several optional output listings. 

The MPEDIT utility section contains the following 
subsections: 

• A description of the input files required 

• A description of the output files: the required 
memory image load module file, and the optional 
listings 

• The method of executing the MPEDIT program 

• The structure of the MPEDIT program 

• Error message discussion 

Addressing for the MPEDIT utility follows the rules 
specified in the MPLINK utility section. 



MPEDIT INPUTS 

MPEDIT requires two files produced by MPLINK: 

• The memory image load module file (ABSOLMP). 
The file structure is shown in appendix D. 



• The symbol table file (SYMTAB). This file 
contains every entry symbol defined during 
MPLINK, together with the symbol's absolute 
location in the memory image file. 

MPEDIT also requires the MPEDIT program. The syntax 
of this program is described in detail in the remainder of 
this section. A sample of parts of an MPEDIT program is 
given in appendix I. 



MPEDIT OUTPUTS 

The MPEDIT utility produces two standard outputs: 

• A memory image load module file with the 
specified variables initialized. 

NOTE 

A variable can take the form of a 
declared constant, a variable, or a field 
within an array. Fields in arrays are 
restricted to 16 bits (one contiguous NPU 
word) in length. 

• A listing of the MPEDIT input program. Any 
syntax errors encountered in this program are 
indicated on this listing. 

Four optional outputs are also supplied: 

• A specially formatted memory image load module 
file, tailored for downline loading on an NPU. 
Format of this load file is given in appendix E. 
This is not the downline-load file for CCP or CCI, 
but is a required input to generate that file. That 
load file itself is generated by the CCP or CCI 
installation procedures. 

• A trace listing of the MPEDIT assignments that 
were made. 

• A listing of the symbol table (SYMTAB) which 
includes local symbols that were introduced during 
the MPEDIT phase. 

• A hexadecimal listing of the memory image load 
module. 



EXECUTING MPEDIT 

MPEDIT is executed by attaching the MPEDIT permanent 
file, and then executing the name call statement MPEDIT 
(see the appropriate NOS or NOS/BE Reference Manual). 

Three optional parameters are available with the MPEDIT 
call statement: 

MPEDIT(D=infile,R=outfile,CSET=cset) 
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where D is the local file which presents the input 
directives to MPEDIT. Default is INPUT. R is the local 
file that receives the listings. Default is OUTPUT. CSET 
is the host display code set to be used. CSET = 63 selects 
the CDC 63-character display code set; this is the default 
value. CSET = 64 selects the CDC 64-character display 
code set. 

Appendix I shows examples of executing MPEDIT. 

Note that the user must rewind the ABSOLMP and 
SYMTAB files prior to entering this utility; MPEDIT does 
not rewind the files before using them. 



MPEDIT PROGRAM SYNTAX 

The statements which comprise an MPEDIT program are 
similar to PASCAL statements (see the CYBER Cross 
Compiler Reference Manual) with some restrictions and 
extentions. A typical extention allows an expression on 
the left side of a VALUE statement. The evaluted 
expression specifies the address which receives the 
assigned value. Comments are permitted as in PASCAL 
statements. Appendix I show selected sections of an 
MPEDIT program. 

As in a PASCAL program, an MPEDIT program has two 
parts which occur in the order given: 

• A definition/declaration section 

• An assignment (initialization) section 

The program ends with a terminator. 

The sections of the program are shown in figure 6-1. The 
MPEDIT flow is shown in figure 6-2. 

The definition/declaration section consists of three parts 
that must occur in the order given: 

• A constant definition part 

• A variable definition part 

• An array definition part 

The assignment section consists of one or more composite 
statements. One composite assignment statement is 
required for the memory resident portion of CCP or CCI; 
one additional composite assignment statement is required 
for each overlay to be edited. If overlay statements are 
present, they must precede the memory resident 
statement. The memory resident statement must be 
present even if it is an empty statement (empty 
statements are defined later). 

The MPEDIT terminator is a period (.) immediately 
following the END statement of the memory resident 
assignment statement. 



MPEDIT SYNTAX 

MPEDIT program uses the following syntax elements: 

• Keywords that designate the part of the program 
or operation to be performed by the assignment 
section 

• Reserved symbols used to order the optional 
outputs 



PROGRAM STRUCTURE 



CONST 



Constant Definition Part 



(1) 



VAR 



Variable Declaration Part 



(1) 



ARRAY 



(1) 



Array Declaration Part 



OVERLAY overlay identifier 

BEGIN 

Assignment Section 
END; 



(2) 



BEGIN 



(3) 



Assignment Section 



END. 



(1) Optional 

(2) Optional composite statement; can be 
repeated for every overlay that requires 
editing up to the maximum number defined 
for the link edit. 

(3) Composite statement; Memory Resident 
Partition. 



Figure 6-1. MPEDIT Program Format 

Local symbols used for equating constant locally, 
or specifiying a local variable 

External symbols in MPEDIT always have an array 
attribute 

Literals 

Address functions 

Expressions 



MPEDIT KEYWORDS 

The following keywords are reserved for MPEDIT controls: 

CONST VAR ARRAY BEGIN END 

OVERLAY FOR TO DO OF 

CHAR DIV MOD 

These control words have the same definitions in the 
PASCAL compiler. 

MPEDIT RESERVED WORDS 

MPEDIT assigns specific output option request meanings 
to the following reserved symbols: 

/TRACE /DMP$ /ESL$ /NAM$ 

MPEDIT assigns specific address meanings to the 
following reserved symbols: 

/PGDISP /PGNUM /PGREG /PGSET /ENTRY 
/START /LENGTH /VFD 
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INPUT 
FILES 




Figure 6-2. MPEDIT Program Flow 



These symbols must be used only to perform the desired 
MPEDIT functions. The functions are discussed later in 
this section. 



MPEDIT LOCAL SYMBOLS 

Local symbols are used to equate a constant in the 
constant definition part of the program or to declare a 
local variable. 

A Local symbol is defined by a slash (/) followed by one to 
six letters and/or digits. The first character must be a 
letter. The dollar sign ($) is considered to be a digit. The 
following are valid local symbols: 

/ABCDEF /A6 /MADM$4 /l 

A local symbol can have more than six letters or digits. 
MPEDIT, however, truncates the symbol at the seventh 
character, and discards that character and all that 
follow. The user cannot, therefore, define two local 
symbols such as /ABCDEFG and /ABCDEFH. MPEDIT 
treats both of these as /ABCDEF. 



An external symbol can have more than six letters or 
digits. MPEDIT, however, truncates the symbol at the 
seventh character, and discards that character and all 
that follow. The user cannot, therefore, define two 
external symbols such as /ABCDEFG and /ABCDEFH. 
MPEDIT treats both of these as /ABCDEF. 

External symbols can be qualified by other external 
symbols. To do this, the user separates the external 
symbols by a period. A single external symbol can be 
progressively qualified by additional external symbols, as 
shown in the examples: 

A36F.FIELD 
GLOBL$.RECORD.FIELD 



where: 



The first external symbol specifies a location on 
the memory image file. 

Intermediate external symbols (if any) specify a 
displacement from the previous location (for 
instance, the start of a record in the global 
variables). 



MPEDIT EXTERNAL SYMBOLS 

External symbols are used during array processing. The 
symbols refer to arrays in the SYMTAB load file produced 
by MPLINK. An external symbol consists of one to six 
letters and/or digits. The first character must be a 
letter. The dollar sign ($) is considered to be a digit. An 
external symbol cannot be one of the keywords defined 
earlier. The following are valid external symbols: 

A36F MAIN$ GLOBL$ UTOPARAM (treated as UTOPAR) 



• The final external specifies a field as: 

A displacement from the start of the previous 
external symbol 

A start bit position for a field 

A field length (in bits) 

This method of qualification is identical to that used in 
the PASCAL syntax. 
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MPEDIT LITERALS 

A literal can be a decimal number (a sequence of decimal 
digits), or a hexadecimal number (a sequence of 
hexadecimal digits preceded by a $). Internally, literals 
are represented as 16-bit quantities. Larger quantities 
are illegal. 

Signed literals are allowed (the leftmost bit is a sign bit). 
A negative literal forces the complement of the 16-bit 
quantity. If a literal is represented by less than 16 bits, 
the unused left bits are packed with binary zeros. 
Examples of legal literals are: 



123 



$147 



-$F 



MPEDIT ADDRESS FUNCTIONS 

MPEDIT provides nine functions that can be used within 
operand or address expressions to generate an address. 
The functions are executed by a reserved word in the form 
/xxxxx. Five of these functions are also available with 
MPLINK (see address functions in MPLINK): 

/PGDISP /PGNUM /PGREG 
/PGSET /OVID 

In addition, MPEDIT defines four more address functions: 

/START /LENGTH /ENTRY 
/VFD 

As in the MPLINK case, the function takes the format: 

/xxxxx (name) 

/START, Field Start Address Function 

The /START function has the format: 

/STARTfexternal) 

The function returns the start position in bits (range 15-0) 
of a field relative to the start of a variable word. For 
example: 

/START(FIELDX) 

generates a bit position of 9 as the start of FIELDX: 

.15 9 





FIELDX 



/LENGTH, Field Length Address Function 

The /LENGTH function has the form: 

/LENGTHexternal) 

The function returns the value of the field length (in bits) 
minus 1. A single bit field has a value of zero; a full word 
field has a value of 15. PASCAL fields cannot exceed 
word length, nor can a field start in one word and 
overflow into the next. 

Example: the length of FIELDX in the example above is 
requested with /LENGTKFIELDX). The address function 
would return a value of 10. 



Example: to find the terminal class field (BSTCLASS) 
start position and length in the base terminal control 
block (TCB) descriptor table, the following MPEDIT 
statements are used: 

DGTCBFDT [53.DDFSTRT := /START(BSTCLASS); 
DGTCBFDT [5].DDFLNTH := /LENGTKBSTCLASS); 



/ENTRY, Entry Point Address Function 

This function accepts a module name as a parameter, and 
generates the address of the module's associated entry 
point. The /ENTRY function has the form: 

/ENTRYfexternal) 

Example: To locate the entry point and the page number 
of the service module in CCP, the following MPEDIT 
statements include address functions: 



BYWLCB [BOSMWL] 
BYWLCB [BOSMWL] 



. BYPRADDR 
.BYPAGE 



/ENTRY(PNSWML); 
/PGNUM(PSSWML); 



/VFD, Variable Field Definition Address Function 

The /VFD function uses three parameters (address/ 
displacement, field start, and field length) to generate the 
location and length of a field in the memory image load 
module file. 

The format of the /VFD specification is: 

/VFD(addr/disp,fldstrt,fldIngth) 

where addr/disp defines the absolute address of the word 
holding the field in the memory image load file; fldstrt 
defines the start bit position of the field within the word 
(range 15-0); and fldlngth defines the length of the field 
(in bits) minus 1 (range 0-15). 

The address expression A, where A is an external, is 
equivalent to the expression: 

/VFD(A,/START(A),/LENGTH(A)) 

or more completely: 

/VFD(A:PGREG(A):/PGSET(A),/START(A),/LENGTKA» 



MPEDIT EXPRESSIONS 

Two types of expressions are used: 

• Operand expressions 

• Address expressions 

Operand Expressions 

An operand expression produces a single 16-bit binary 
value. An expression is a valid combination of: 

• constants (which are interpreted as 16-bit integers) 

• local variables 

• functions 

• unqualified external symbols 
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These are joined together by arithmentic operators (+, -, 
*, DIV, and MOD), and are grouped within parentheses to 
specify the order in which the operations are to be 
performed. An evaluated external symbol is represented 
by its address/displacement value. Qualified address 
values can be accessed using the address evaluation 
functions given in MPLlNK and MPEDIT, above. 

In an operand expression, an external symbol cannot be 
subscripted, even if it is declared in an array. The NPU 
performs all arithmetic in one's complement mode so that 
results are unique. 

Examples of operand expressions are: 

GLOBL$ 

(/PGREG(MOD)+$F21) DIV /START(GLOBL$) 



Address Expressions 

An address expression has one of two forms: 

• A /VFD address function call 

• A single external symbol. The symbol can be 
qualified. If this form is used, symbols that are 
declared in arrays must be properly subscripted; 
that is, the subscript expressions must be operand 
expressions with values that fall within the 
expected range. 

Examples: 

■ A 



/symboUexpression; 

that is, the declaration consists of a local symbol, an 
equal sign, and a literal, or a previously defined, 
constant. The declaration terminates with a semicolon. 
Literal and previously defined constants can be signed. 

It is possible to define a constant value as an expression 
which itself is a mixture of constants, previously declared 
local constants, and entry symbols which appear in 
SYMTAB. 

Examples are given in figure 6-3. 



Requesting the Optional Form of the 
Initialized Load Module File 

The pseudoconstant /NAM$ is used in MPEDIT to request 
the optional form of the initialized memory image load 
file. That load file is especially formatted for downline 
loading in the NPU. Format of the file is shown in 
appendix E. 

Any three-character identifier can be assigned to the 
/NAM$ definition. The identifier specified is placed in 
the heading of the load file. An example of the /NAM$ 
definition is: 

/NAM$ := OE2 

The definition can appear anywhere in the CONST 
definition part of the program. 

NOTE 



This is an address expression unless A was 
declared in an array. In that case, the lack of 
subscripts indicates it is an operand expression. It 
could also be an operand expression if its usage 
forced that conclusion; that is, it is on the 
righthand side of an assignment statement. 

• A [2] 

/VFD (MAIN$,0,0) 

• ARRAY ACL.5,1..5] OF 24; 

CC1..10] OF CHAR; 

VAR/I; /J 



This alternate form is not the final 
form of the load file that is 
downline-loaded into an NPU to provide 
the on-line CCP or CCL Instead, as 
shown in figure 1-1, the CCP or CCI 
installation procedures use a load file 
generating utility to process this 
optional form of the memory image 
load module file along with other load 
files. After processing by the host's 
load file generating utility, the 
reformatted and combined load file can 
be downline-loaded into an NPU. 



A C/I,(/START(Q)-2)*/J ] .ac [3 ] 'address 
expression' 



MPEDIT PROGRAM STRUCTURE 



CONSTANT DECLARATION PART 

The first part of an MPEDIT program contains constant 
declarations; this section is optional. Constant 
declarations allow programmers to create synonyms for 
literals. A local symbol that is defined as a constant 
behaves as a true constant; its appearance is legitimate 
wherever a literal is expected. 

If a constant declaration part is present, it is preceded by 
the keyword, CONST. The complete list of constant 
declarations must follow that word. 

Each declaration has the following format: 



VARIABLE DECLARATION PART 

The next part of an MPEDIT program contains variable 
declarations; this section is also optional'. It allows 
programmers to create local symbols for local variables. 
These symbols exist only during the MPEDIT phase. All 
such variables are 16-bit quantities that can be used in 
one's complement arithmetic. 

If the variable declaration part is present, it is preceded 
by the keyword, VAR. That word is followed by the 
complete list of local variable declarations. 

Each declaration has the following format: 

/symbol; 

that is, the declaration consists of a local symbol followed 
by a semicolon terminator. 

Example of a variable declaractions are given in figure 
6-3. 
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CONSTANT DECLARATIONS 




CONST 




/TRUE = 1; 




/FALSE = 0; 




/COUPLER = $0000; 




/PORT01 = $0100; 




/PORT02 - $0200; 




/B0S1 - 1} 




/B0S16 = /BOS1; 




/BFLCDO = /BUFSZ0*2 • 


- /J1LSTPAD; 


/DBFSZE = /BECTLBK + 


(3*/SIZBECTLBK); 


VARIABLE DECLARATIONS 




VAR 




/I 




/I3 




/P 




/IDTBL 




/BZOWNER 




/BZLNSPD 




/BSCN 




/BSPGWAIT 




ARRAY DECLARATIONS 




ARRAY 





JZOPSBASE [BOCHWL..B0DUMMY] OF 2; 

DBPFCTBLE [1..DBLAST] OF 2; 

CGTCBS [0. .C4TCM1 ] OF /SIZTCB 
VATCBAT [1..40] OF 3; 

JGTESTABLE /FALSE. ./TRUE, /FALSE. . /TRUE, /FALSE. ./TRUE ] OF 1; 
NAMEN [1..20] OF CHAR; 



Constants as decimal numbers 
Constants as hexadecimal numbers 

Constants as previously defined constant! 
Constants as arithmetic expressions 



general loop index 
general use variable 
work pointer for program 
table work pointer 
local variables 



sequence of elements defined by symbols; 

numerically defined size 
sequence of elements defined by symbols; 

constant defined size 
combination of both of the above 

sequence of elements defined by 

numbers; numerically defined size 
sequence of element sets defined by 

symbols; numerically defined size 
sequence of elements defined by numbers; 

elements packed two per NPU word. 



Figure 6-3. Examples of MPEDIT Constant, Variable, and Array Declarations 



ARRAY DECLARATION PART 

The next part of an MPEDIT program contains array 
declarations; this section is also optional. Array 
declarations allow programmers to create external 
symbols as arrays so that elements can be referenced by 
an index. Any external symbol that is to be indexed must 
be declared as an array. 

If the array declaration part is present, it is preceded by 
the keyword, ARRAY. That word is followed by the 
complete list of array declarations. 

A declaration can have either of two formats: 

name [index] OF number; 

name [index] OF CHAR; 

In each case, the name is an external symbol, the index is 
a range of numbers in PASCAL notation 
(number..number), and the declaration is terminated with 
a semicolon. Note that number itself can be an 
expression. If the CHAR format is used, the array 
corresponds to a PASCAL packed array; that is, there are 
two characters packed per NPU word. 



Examples of array declarations are shown in figure 6-3. 

ASSIGNMENT SECTION 

There are two general types of assignment sections: 
resident assignments and overlay assignments. All overlay 
assignments must precede the resident assignment 
section. The two types are identical except that each 
overlay assignment section begins with: 

OVERLAY overlay identifier 

An assignment section consists of a single composite 
statement which is delimited by the keywords BEGIN and 
END. The composite statement consists of zero or more 
statements which direct the MPEDIT actions to be 
performed. There are five types of assignment 
statements: 

• Local assignment statements 

• Address assignment statements 

• FOR loop statement 
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• An embedded composite statement 

• Empty statement 

Each statement (except the last) is terminated by a 
semicolon. 

An MPEDIT program must include an assignment section 
for the memory resident programs, even if that section 
consists of only one empty statement. 

Selected portions of an assignment section for a CCP 
MPEDIT program are given in appendix I. 

Local Assignment Section 

A local assignment section statement has the following 
format: 

local variable := operand expression 

where := is the assignment operator. 

MPEDIT evaluates the operand expression to find the 
value, and places that value in the named local variable. 
Examples of local address assignment statements are: 

VAR /I; /J; /K; /L; 



/I:-A+l; /J:=0; /K := /LENGTH(X); 

/L := /VALUE(A.B)+C; 

Address Assignment Section 

An address assignment statement has the form: 

address expression := operand expression 

An address expression can take the form of an operand 
expression (that is, the operand expression can appear on 
the lefthand side of the assignment operator). In this 
case, a /VFD with full-word attributes is implied. 

Semantically, MPEDIT evaluates the righthand-side 

operand expression, and replaces the value in the memory 

image location specified on the lefthand side with this 
new value. 

If a 16-bit value is assigned to a smaller than 16-bit field, 
the higher order bits are truncated. 

As mentioned above, an address assignment statement can 
have an operand expression on the lefthand side. For 
example: 

/I+l := is interpreted as /VFD(/I+1,15,15) := 

MPEDIT is instructed to zero the full 16-bit word that 
appears at location /I+l. Similarly, 1 := would zero the 
full word at memory image location 1. 

Example: 

VAR /I; 



This sets the local variable /I to zero. To zero the word 
at memory location /I, the lefthand side of the assignment 
must be forced to look like an expression. This could be 
done in any of the following three ways: 

• + /I := 

• (/I) := 

• /VFD(/I,15,15) := 



FOR Statement 

The FOR statement in MPEDIT is entirely analagous to 
the FOR ... TO statement in PASCAL. The statement 
causes the indicated statement to be repeated, while a 
progression of values is assigned to a control variable. 
The basic form of the FOR statement is: 

FOR control variable := initial operand expression 
TO final operand expression 
DO statement 

The FOR ... TO statement assigns values for the control 
variable in increasing order. The control variable must be 
a local variable. 

In the following example, the FOR statement causes 
MPEDIT to set 256 successive locations, beginning at the 
external symbol GLOBL$, with the value of the preceding 
memory location's address: 

VAR /I 



FOR /I := GLOBL$ 

TO GLOBL$ + $FF 
DO (/I) := /I - 1 



Composite Statement 

A composite statement is a sequence of statements (which 
can include embedded composite statements) that are to 
be executed in the order specified. A composite 
statement is delimited by BEGIN and END. The format of 
the statement is: 



BEGIN 



statement; 
statement; 



statement 



END. 

A composite statement is interpreted syntactically as a 
single statement. It is used to delimit the entire 
assignment section. It is also useful for specifying several 
statements which are to be acted upon as a single 
statement. 

The example in figure 6-4 gives alternative ways of 
packing an array. 



/I:=0 
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METHOD 


1 


VAR /I; 






FOR /I := TO 49 


DO 




BEGIN 

/VFD(GLOBLS+/I 
/VFD(GLOBL$+/I 

ENS; 


,15,7) : 
,7,7) :• 


- SAD; 
/I 




METHOD 


2 



VAR /I; /J; /K; 

ARRAY GLOBL$ [0..99] OF CHAR; 

/K := $4D; 

FOR /I := to 49 DO 

BEGIN 

/J :- 2*/I; 

GLOBL$ C/J ] := /K; 

GLOBL$ C/J+l] :- /I 
END; 



This example packs an array of 50 NPU (16-bit) 
words starting at location GLOBL$. Value $4D 
is placed in the upper half word, and the word 
count (0 through 49) in the lower half word. 



Figure 6-4. Methods of Packing an NPU Array 



Empty Statement 

The empty statement is analagous to the empty PASCAL 
statement. It contains no information; it can be used 
anywhere that a statement is appropriate. The empty 
statement exists so that a syntax error is not generated if 
the user inadvertently enters a semicolon. This most 
frequently occurs after the statement which preceded the 
END statement in a composite statement. 



Comments 

Comments can be introduced in any position within a 
statement that does not violate a keyword or a symbol. 
Comments are delimited at the beginning by an ASCII 
underscore (this appears as a broken arrow in display 
code), and at the end by an ASCII question mark (this 
appears as a down arrow in display code). Any character 
can be used within a comment except the delimiters. 



Requesting a TRACE Operation 

The pseudovariable /TRACE is used in MPEDIT to request 
a trace listing. The trace listing presents the following 
information 

• The address or field that is initialized 

• The value to be inserted into the field 



• The previous contents of the full 16-bit word 
holding the field (the field can be all or only a 
part of that word) 

• The current contents of the full 16-bit word after 
the initializing value is inserted 

• The line number of the MPEDIT program which 
caused initialization of the field 

Format of the pseudovariable requesting a trace listing is: 
/TRACE := x; 

If the value for /TRACE is 2 or greater, the listing is 
produced. If /TRACE is assigned a value of or 1, the 
trace report for that /TRACE entry is not produced. 
Default value for /TRACE is 2. The pseudovariable can 
appear anywhere in the assignment section; however, only 
those assignment statements that appear after the trace 
request will be included in the listing. For this reason it is 
customary to define the pseudo variables at the beginning 
of the assignment section. 

A partial trace listing is shown in figure 6-5. 



Requesting the SYMTAB Listing 

The pseudovariable /ESL$ is used in MPEDIT to request a 
listing of the symbol table (SYMTAB). This report 
includes the local symbols. The report is generated at the 
end of an MPEDIT run. Format of the request is: 



/ESL$ 



:x; 



If the value of x is 2 or greater, the SYMTAB listing is 
produced; if the value is or 1, the listing is suppressed. 
The default value for /ESL$ is 0. 

The request can appear anywhere in the assignment 
section of the program. A sample partial SYMTAB listing 
is shown in figure 6-6. The listing was requested by the 
pseudovariable declaration: 

/$ESL := 2; 



Requesting the Initialized Load Module File Listing 

The pseudovariable /DMP$ is used in MPEDIT to request a 
listing of the initialized memory image load module file. 
Format of the request is: 

/DMP$ :=x; 

If the value of x is 2 or greater, the listing is produced; if 
the value is or 1, the listing is suppressed. Default value 
for /DMP$ is 2. The request can appear anywhere in the 
assignment part of the program. 

The memory image load module file values are listed in 
hexadecimal; the listing is generated at the end of a 
MPEDIT run. 



MPEDIT DIAGNOSTICS 

Some types of statement faults cause errors from the 
programmer's standpoint, but do not generate an error 
message. Others can generate one or more error 
messages. Any of the following types of statements fail: 

• statement has an undefined identifier 



6-8 



60471200 F 



CYBER »1INI CROSS SVSTEH - LINK EOITOR 
TRACE LIST 



578 


VF0($0O16A» 


*F, 


tF» 


la 


0096 


; oooo 


l» 


0096 


579 


VFD(t0016B, 


$F, 


tF) 


:> 


OOOF 


; oooo 


* 


OOOF 


580 


VFDftOOt67, 


tF. 


tF) 


3 a 


0032 


; oooo 


& 


0032 


581 


VFDf 100168, 


IF, 


tF) 


: « 


0000 


; oooo 


1* 


0000 


582 


VF0<t0O169, 


if, 


IF) 


: a 


onoo 


; oooo 


l» 


OOOO 


5V 5 


VF0(t0F67E> 


IF, 


tF) 


3 a 


F659 


; oooo 


r» 


F659 


600 


VFDtt0108Q, 


tF, 


IF) 


:« 


0020 


; oooo 


■» 


0020 


601 


VFD.101081. 


tF, 


IF) 


: * 


0005 


; oooo 


r» 


0005 


608 


VFD(tOUAl, 


tF» 


tF) 


: a 


8093 


; oooo 


* 


8093 


609 


VFD(t011A0, 


18, 


tei 


: • 


0010 


i oooo 


* 


0010 


610 


tfHD(10119fc, 


IF, 


$4) 


: m 


0009 


i oooo 


* 


4800 


611 


VF0I1O11AO, 


IE. 


15) 


: » 


0001 


0010 


A 


0210 


612 


VFDMQ119D. 


17, 


17) 


: a 


0002 


; oooo 


r> 


0002 


613 


VFDCtOllAO, 


tF, 


10) 


: a 


0001 


; 0210 


it 


8210 


617 


tfF0(tCllA9. 


tF, 


IF) 


: * 


7602 


oooo 


1* 


76D2 


618 


VFO( J011A8. 


te. 


13) 


: • 


0006 


, oooo 


l» 


OOOE 


619 


VFD(t011A6, 


tF, 


14) 


3 a 


OOOA 


, oooo 


1* 


5000 


620 


VFOItOllAB. 


ie» 


15) 


: a 


0004 


OOOE 


l» 


OBOE 


621 


VFO(i011A5, 


17. 


17) 


: • 


0002 


OOOO 


* 


0002 


62? 


VFDCI011A8, 


tF, 


10) 


; a 


0001 


0806 


l» 


980E 


6?6 


VFOftOllBl, 


tF. 


tF) 


: * 


5179 


OOOO 


* 


5179 


627 


VFOdOUBO. 


t8. 


181 


Sa 


OOCA 


oooo 


■» 


OOOA 


628 


VFDdOllAE, 


tF, 


14) 


: • 


oooa 


oooo 


t» 


5800 


6»9 


VF0J1O11BO, 


tE, 


15) 


: » 


OOOA 


OOOA 


l» 


140A 


630 


VFD( tOllAO, 


t7, 


»7> 


: < 


0005 


OOOO 


f» 


0005 


631 


VFDCtOllBO, 


tF, 


10) 


3 a 


0001 


140A 


* 


940A 


635 


VFD(101169. 


IF. 


IF) 


■ a 


2189, 


OOOO 


* 


218? 


636 


V C D(1011B8, 


te. 


18) 


: a 


0004, 


OOOO 


* 


0004 


637 


VF0(tC1196. 


tF, 


14) 


3 a 


oooc- 


oooo 


!» 


6000 


633 


VFDdOllBfl. 


iF» 


15) 


: a 


0001, 


0004 


t» 


0204 


639 


YFD<1011B5» 


t7, 


17) 


: * 


0004j 


oooc 


r» 


0004 


640 


VFOf 10U9S, 


IF, 


10) 


1 M 


0001' 


0204 


A 


9204 


644 


VFDC1011C1. 


tF, 


IF) 


i 35 


69E5i 


OOOO 


rf 


69?5 


645 


VFDttOUCO, 


18, 


18) 


I a 


0000; 


OOOO 


» 


OOOO 


646 


VFDC1011BE, 


tF, 


141 


J a 


oooo; 


OOOO 


* 


6800 


647 


VFDdOllCO. 


tE, 


15) 


: a 


0001 ! 


OOOO 


t» 


0200 


648 


VFDdOllBO, 


t7, 


17) 


I a 


0001; 


OOOO 


t» 


0001 


649 


VFDdOllCO, 


tF, 


10) 


: a 


ooou 


0200 


r» 


8200 


653 


VFDdOUC9, 


tF, 


IF) 


: a 


8093; 


oooo 


* 


8093 


654 


VFDd011C8, 


18, 


18) 


: a 


0010; 


oooo 


l» 


0010 


655 


VFDd011C6. 


tF, 


14) 


: a 


OOOE; 


oooo 


* 


7000 


656 


VFDdOUCB, 


tF. 


15) 


: a 


0001; 


0010 


I» 


0210 


657 


VFDd011C5, 


17, 


17) 


: a 


0006; 


oooo 


l» 


0006 


658 


VFDdOllCB. 


tF, 


10) 


! a 


oooi; 


0210 


* 


8210 


662 


VFOdOUOl, 


IF, 


IF) 


is 


3039; 


oooo 


f> 


3D39 


663 


VFDdOllOO. 


18, 


18) 


3a 


002F; 


oooo 


1» 


00 2F 


664 


VFDdOllCE, 


IF, 


14) 


8a 


OOOF; 


oooo 


* 


7800 


665 


VFDdOUOO, 


tE, 


t5) 


3 a 


0001 J 


002F 


l» 


022F 


666 


VFDdOllCD, 


J 7, 


t7> 


3 a 


0003t 


oooo 


* 


0003 


667 


VFDdOUOO, 


tF, 


10) 


3a 


0001; 


02 ZF 


* 


822F 


471 


VFDd01231, 


IF, 


tF) 


3a 


65 3C; 


OOOO 


l» 


653C 


672 


VFOd01230, 


18, 


18) 


Sa 


OOOCl 


oooo 


I» 


OOOC 


673 


VF0dO122E, 


tF, 


14) 


3a 


0018 1 


oooo 


r> 


D800 



6 74 


VF0(t01230, 


IE, 


15) 


3 a 


0001; 


OOOC # 


020C 


675 


VF0IS0122D, 


t7, 


17) 


3 a 


oooi; 


0000 # 


0001 


676 


VFO(t01230, 


tF, 


10) 


3 a 


0001; 


020C * 


820C 


680 


VFOf t0115D, 


17, 


t7) 


! a 


0003; 


0000 f> 


0903 


681 


VF0tt01165, 


t7, 


17) 


3 a 


OOOI; 


OOOO t» 


0001 


692 


VF0II01160, 


t7, 


t7> 


3 a 


0003; 


OOOO •» 


0003 


683 


VF0(t01175, 


$7, 


t7> 


3a 


0002; 


OOOO * 


0002 


684 


VF0I101170, 


t7, 


17) 


3 = 


0001; 


OOOO ■> 


0001 


695 


VF0ltO1185, 


17, 


»7> 


3 a 


0001; 


OOOO * 


0001 


686 


VFOI 101180, 


17, 


17) 


3 a 


0001; 


OOOO » 


0001 


698 


VFDCt01530, 


tF, 


IF) 


; a 


0004; 


OOOO r* 


0004 


694 


VFD<t01774, 


tF, 


IF) 


3 a 


0002; 


OOOO r» 


0002 


695 


VFD(t01775, 


IF, 


tF) 


; a 


0001; 


OOOO t» 


0001 


696 


VFD(t01776, 


IF, 


tF) 


; a 


oood; 


OOOO r» 


oooo 


697 


VFD(t01777, 


tF, 


IF) 


Sa 


6AFD; 


OOOO i» 


6AFD 


698 


VF0(t01778, 


tF, 


IF) 


i a 


0OFO; 


OOOO r> 


OOFO 


699 


VFD<101779, 


tF, 


tF) 


a 


oofo; 


OOOO & 


OOFO 


700 


VFD(10177B, 


tF, 


tF) 


3a 


5065; 


OOOO * 


5065 


701 


VF0(10177A, 


tF. 


IF) 


* a 


0008; 


OOOO r» 


OOOB 


702 


VFO(t0177C, 


IF, 


IF) 


a 


0002; 


OOOO * 


0002 


703 


VF0lt01770, 


IF, 


IF) 


a 


0001; 


OOOO * 


0001 


704 


VF0(t0177E, 


tF, 


IF) 


a 


0010; 


OOOO ,» 


0010 


705 


VF0(t0177F, 


IF, 


IF) 


a 


9093; 


OOOO & 


8093 


706 


VFD<t01780, 


tF, 


IF) 


a 


0002; 


OOOO ■» 


0002 


707 


VFOC 101781, 


IF, 


IF) 


a 


0002; 


OOOO * 


0002 


708 


VFD(t017B2, 


IF, 


tF) 


a 


oooo; 


OOOO r. 


OOOD 


709 


VF0(t01793, 


IF, 


IF) 


a 


6B89; 


OOOO t» 


6B89 


710 


VFD(t01788, 


IF, 


IF) • 


a 


3078; 


oooo ■* 


0078 


711 


WF0(t01789, 


tF, 


IF) i 


a 


0078; 


ocoo » 


0078 


712 


VFDC10178A, 


IF. 


tF) • 


a 


0009; 


oooo * 


0008 


713 


VFO(t0173B, 


IF, 


tF) 


s 


413F; 


oooo » 


413F 


714 


VFD(t0178C, 


tF. 


IF) 


a 


0002; 


0000 r> 


0002 


715 


VF0(t0178D, 


IF, 


IF) ! 


a 


0001; 


OOOO r» 


0001 


716 


VF0(tO178E, 


tF, 


IF) 1 


a 


0010; 


OOOO •» 


0010 


717 


VFDd0178F, 


tF, 


tF) ! 


a 


8 09 3; 


OOOO r» 


8093 


718 


VF0(t01794, 


tF. 


tF) 3 


a 


0002; 


OOOO r> 


0002 


719 


VFD($01785, 


tF, 


IF) 3 


a 


0002; 


OOOO f» 


0002 


720 


VFDd01766, 


IF, 


IF) 3 


a 


oooe; 


OCOO i» 


OOOE 


721 


WF0lt01797, 


IF, 


IF) ! 


a 


7682; 


OOOO r> 


76B2 


722 


VFOf $01790, 


$F, 


IF) 3 


a 


0014; 


OOOO •» 


0014 


723 


VFDIS01791, 


tF. 


IF) 3 


a 


0014; 


oooo •» 


0014 


724 


VFDdOl792, 


IF, 


IF) s 


a 


0008; 


OOOO i» 


0008 


725 


VFDC $01793, 


tF, 


IF) ! 


a 


444C; 


OOOO ■» 


444C 


726 


VFDXS017A4, 


tF, 


tF) 3 


a 


OOOO; 


OOOO r» 


OOOO 


727 


VFDI1017A5, 


tF, 


IF) s 


a 


OOOO; 


OOOO •» 


OOOO 


728 


VF0(t017A7, 


tF, 


IF) I 


a 


OOOO; 


OOOO r» 


OOOO 


739 


VFDd01859, 


to, 


tl) 3 


a 


oooi; 


OOOO i» 


1000 


740 


WF0(t01859, 


14, 


14) > 


a 


OOOB; 


1000 * 


100B 


744 


VFDC101867, 


to, 


tl) I 


a 


oooi; 


OOOO i> 


1000 


745 


VFDU01867, 


14, 


14) : 


a 


0009; 


1000 •» 


1009 


746 


WFO(t01867, 


t7, 


121 : 


a 


0002; 


1009 >♦ 


1049 


750 


VFOI 101883, 


t4, 


t4) J 


a 


OOOF; 


oooo ■» 


OOOF 


751 


VFDItOlSBB* 


$F, 


tF) : 


■ 


oooe; 


oooo •» 


OOOE 



Figure 6-5. Partial MPEDIT Trace Listing 



• 8tatement causes an attempt to assign a 
nonexistent memory location 

• statement has a bad field specification (overflows 
word or has an illegal format) 

• statement has an out-of-range subscript 

A failed statement behaves functionally like a null 
statement. The following examples show failed 
statements. 



Example 1: 
U:=0 

where U is an undefined identifier. This acts as an empty 
statement. 

Example 2: 

VAR /I; 



FOR /I := $100 TO $202 DO 
(/I) := 
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6-9 



CYBER MINI CROSS SYSTEM - LINK EDITOR - 



ENTRY SYNBOL LIST - SORTED BY ENTRY N*NE 



*ENT*Y**» /A** ADDRESS /VALUE**B IT S/L* 



*ENIRY**R/A**AODRESS/VAlUE**BIT S/L* 



*ENTRY**R/A**ADDRESS/VALUE**BIT S/L* 



AACAPL P 


493C 


ADST2 


A 


0002 


AACDAD * 


OOOO 


AFABLS 


R 


474A 


AACDPT A 


ocao 


AEAPL 


R 


11709 > 3709 


AACORR R 


4«*C 


AEASCI 


R 


46A7 


AAEAPL R 


4BFC 


AEATTN 


R 


4769 


AAE3CD R 


4BFC 


AEATT1 


R 


4775 


AANRFA A 


0007 


AEAUT1 


R 


4648 


AAQUTP A 


0303 


AEAUT2 


R 


464? 


AAREAD A 


0C04 


AFAUT3 


R 


4654 


AAS8AP R 


4A3C 


AFBLS 


R 


45B4 


AASTA" » 


49FC 


AECHR1 


R 


4660 


ABAPLA R 


*9«C 


AECIN1 


R 


460A 


ACAPL R 


UbED:36£D 


AECIMZ 


R 


460C 


ACARTO » 


0078 


AEC1N3 


R 


46E7 


ACAIITO A 


0001 


AFC114 


R 


46E9 


ACCAPL A 


0004 


4ECKN0 


R 


45AB 


ACCAPL I 


300* 


A?C001 


R 


46C0 


ACCASt P 


ll»!i)T:^«,R7 


AEC01? 


R 


46A0 


ACCORP A 


0003 


AEC3E 


R 


116D7S3607 


ACCORR L 


0003 


AECSLL 


R 


47VF 


AC DEL* A 


000? 


AFCSL1 


"R 


477A 


AC6»PL L 


000? 


AECSLZ 


R 


477C 


AC=APL A 


0032 


Ate 1*1 


R 


46F5 


ACEBCD A 


P001 


AEEH2 


R 


46F7 


ACEBCB L 


00P1 


AEFIN3 


R 


4702 


ACELL A 


OCul 


AFEH4 


R 


4704 


ACEPL A 


3031 


AE?LL 


P 


45C5 


ACKMSG R 


S58E 


AcELTl 


R 


45CE 


ACKPTR R 


lObB 


AEELT3 


R 


45F0 


ACLIH2 A 


■jooo 


AEEPL 


R 


45F1 


ACIIM1 A 


CA03 


AE?PT1 


R 


45FB 


ACPBU A 


0001 


AEESL1 


R 


4780 


4C»BOB A 


000? 


AtESLZ 


P 


4782 


AC»CLR A 


oooc 


AEINPT 


R 


4583 


ACPEYF A 


3000 


AEINl 


R 


4 58C 


ACMCS A 


oo%o 


AEHBT 


R 


455F 


ACPIOM A 


0063 


AESE3I 


R 


47 3C 


ACPLRl R 


1CC0 


AESLL 


R 


4570 


ACPOBL A 


0058 


AES110 


R 


465B 


ACPOHA A 


006C 


AESliO 


R 


4668 


AC PONS A 


0048 


AES151 


P 


4662 


ACPRHA A 


0010 


AES300 


R 


4674 


ACRITT A 


oaoA 


AES301 


R 


467A 


ACRLF L 


0003 


AEXBLS 


R 


4635 


ACR t 


0301 


AEXDLH 


R 


463A 


AODRES R 


0150 


AEXDTA 


R 


462A 


ADDRLC P 


015F 


AEXPTO 


R 


46ZF 


AOORSU R 


0160 


AEXSOI 


R 


4604 


AOEAOT A 


0014 


AE4X0L 


R 


4T»T 


ADST1 A 


0001 


AE4XIN 


R 


4792 




Figure 6-6. Partial MPEDIT SYMTAB Listi 



AIOLET 


A 


0003 




AIDLE 


A 


0001 




AINPLB 


A 


OOOE 




AINPSB 


A 


OOOO 




AISPT1 


R 


4405 




AISPT6 


R 


452A 




AISP4C 


R 


4512 




AISP4E 


R 


44FA 




ALARM 


A 


0001 




ALARM? 


A 


0002 




ALARH3 


A 


0003 




ALCAPL 


R 


4C7C 




ALCCRA 


R 


4ABC 




ALE API 


R 


4BBC 




ALEBCO 


R 


4B3C 




AlF 


L 


0002 




ANIL 


L 


OOOO 




ASASCI 


A 


0022 




ASAUTO 


A 


001B 




ASCE26 


R 


1S39C039C 




ASCE?9 


R 


1535CS335C 




ASCINT 


R 


176C 




ASOISC 


A 


0003 




ASSLL 


A 


0004 




ASSOL 


A 


0001 




ASXPT 


A 


0002 




ASXSOI 


A 


0005 




ASYNCE 


R 


153A 




AS2741 


A 


0020 




ATAPLA 


R 


497C 




ATELL 


A 


OOOO 


F»7 


ATE PL 


A 


OOOO 


7«7 


ATP0I2 


R 


1131B031B 




ATP0I5 


R 


1133FI333F 




ATPDI6 


R 


1136313363 




ATPDI8 


R 


11387s 3387 




ATPPR1 


R 


112D3t3203 




ATPPR4 


R 


11ZF2S32F2 




AUCAPL 


R 


4C3C 




AUCCRA 


R 


4A7C 




AUEAPl 


It 


4B7C 




AUEBCD 




4 AFC 




AVASCE 




1172913729 




AVASCP 




1EJ0 




AVB7T0 




1E74 




AVCNTR 




1E30 




AVCORE 




1173*1 373A 




AVCORR 




1E»E 




AVCRtF 




1E52 




AVCRNS 




1E50 





where only addresses $100 through $1FF are defined in the 
load file. In this case, 259 assignment statements are 
executed. The first 256 are valid; the last three fail. 

If a failed statement or other error causes an error 
message, the error message is delivered to the output 
file. The messages are preceded by an up arrow. If the 
error is a recognized syntax error, trie up arrow is 



followed by the character that was being processed when 
the error occurred. 



MPEDIT ERROR MESSAGES 

Table B-6 in appendix B lists the MPEDIT error messages, 
the message meaning, and the action which the operator 
or programmer should take in response to the message. 
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CHARACTER SET 



The CYBER host uses one of two character sets to the • 63-character ASCII 

CYBER Cross Build Utilities: ■ 64-character ASCII 



These code sets are shown in table A-l. 
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rs) 



TABLE A-l. 63/64 CHARACTER ASCII CODE 



s 

N3 

s 





ASCII 




Hollerith 


External 


ASCII 






ASCII 




Hollerith 


External 


ASCII 




CDC 


Graphic 


Display 


Punch 


BCD 


Punch 


ASCII 


CDC 


Graphic 


Display 


Punch 


BCD 


Punch 


ASCII 


Graphic 


Subset 


Code 


(026) 


Code 


(0291 


Code 


Graphic 


Subset 


Code 


(026) 


Code 


(029) 


Code 


:t 




OOtt 


8-2 


00 


8-2 


072 


6 


6 


41 


6 


06 


6 


066 


A 


A 


01 


12-1 


61 


12 1 


101 


7 


7 


42 


7 


07 


7 


067 


B 


B 


02 


12-2 


62 


12-2 


102 


8 


8 


43 


8 


10 


8 


070 


C 


C 


03 


12-3 


63 


12-3 


103 


9 


9 


44 


9 


11 


9 


071 


D 


D 


04 


12 4 


64 


12-4 


104 


+ 


+ 


45 


12 


60 


12-8-6 


053 


E 


E 


05 


12-5 


65 


12-5 


105 


- 


- 


46 


11 


40 


11 


055 


F 


F 


06 


12-6 


66 


12 6 


106 


# 


* 


47 


1 1 -8-4 


54 


1 1 -8-4 


052 


G 


G 


07 


12-7 


67 


12-7 


107 


/ 


/ 


50 


0-1 


21 


0-1 


057 


H 


H 


10 


12-8 


70 


12-8 


110 


( 


( 


51 


0-8-4 


34 


12-8-5 


050 


1 


1 


11 


12-9 


71 


12-9 


111 


) 


1 


52 


12-8-4 


74 


11-8-5 


051 


J 


J 


12 


11-1 


41 


11-1 


112 


$ 


$ 


53 


11-8-3 


53 


11-8-3 


044 


K 


K 


13 


11-2 


42 


112 


113 


= 


= 


54 


8-3 


13 


8-6 


075 


L 


L 


14 


11-3 


43 


11-3 


114 


blank 


blank 


55 


no punch 


20 


no punch 


040 


M 


M 


15 


11-4 


44 


11-4 


115 


, (comma) 


, (comma) 


56 


0-8-3 


33 


0-8-3 


054 


N 


N 


16 


11-5 


45 


1 15 


116 


. (period) 


. (period) 


57 


12-8-3 


73 


12-8-3 


056 








17 


116 


46 


11-6 


117 


~ 


# 


60 


0-8-6 


36 


83 


043 


P 


P 


20 


117 


47 


11-7 


120 


[ 


( 


61 


8-7 


17 


12-8-2 


133 


Q 


Q 


21 


11-8 


50 


11-8 


121 


I 


1 


62 


0-8-2 


32 


1 1 -8-2 


135 


R 


R 


22 


11-9 


51 


11-9 


122 


% 


% 


63tt 


8-6 


16 


0-8-4 


045 


S 


S 


23 


0-2 


22 


0-2 


123 


# 


" (quote) 


64 


8-4 


14 


8-7 


042 


T 


T 


24 


0-3 


23 


0-3 


124 


-» 


_ (underline) 


65 


0-8-5 


35 


0-8-5 


137 


U 


U 


25 


0-4 


24 


0-4 


125 


V 


! 


66 


11-0 or 


52 


12-8-7 or 


041 


V 


V 


26 


0-5 


25 


0-5 


126 








11-8-2ttt 




11-Ottt 




w 


w 


27 


0-6 


26 


0-6 


127 


A 


& 


67 


0-8-7 


37 


12 


046 


X 


X 


30 


0-7 


27 


0-7 


130 


t 


1 (apostrophe) 


70 


11-8-5 


55 


85 


047 


Y 


Y 


31 


0-8 


30 


0-8 


131 


1 


? 


71 


11-8-6 


56 


0-87 


077 


2 


z 


32 


0-9 


31 


0-9 


132 


< 


< 


72 


12-0 or 


72 


12-8-4 or 


074 








33 





12 





060 








12-8-2ttt 




12-0ttt 




1 


1 


34 


1 


01 


1 


061 


> 


> 


73 


11-8-7 


57 


0-8-6 


076 


2 


2 


35 


2 


02 


2 


062 


£ 


9 


74 


8-5 


15 


8-4 


100 


3 


3 


36 


3 


03 


3 


063 


£ 


\ 


75 


12-8-5 


75 


0-8-2 


134 


4 


4 


37 


4 


04 


4 


064 


H 


■—(circumflex) 


76 


12-8-6 


76 


1 1 -8-7 


136 


5 


5 


40 


5 


05 


5 


065 


; (semicolon) 


; (semicolon) 


77 


12-8-7 


77 


11-8-6 


073 


tTwelve or more zero bits at the end of a 60-bit word are interpreted as end-of-line mark rather than two colons. End-of-line 




mark is converted to external BCD 1632. 










ttln installations using a 63-graphic set, display code 00 has no associated graphic or card code; display code 63 is the colon (8-2 punch). 


The % graphic and related card codes do not exist and translations from ASCII/EBCDIC 


% yield 


a blank (55p). 






tttThe alternate Hollerith (026) and ASCII (029) punches are accepted for input only. 









UTILITY DIAGNOSTIC MESSAGES 



B 



Each of the utilities described in this manual generates a 
set of error and (in some cases) informational messages. 
Some of these messages are sent to the output file (error 
file), and others are sent to a special fatal error file. 

The error messages in this appendix are arranged by 
utility type. The tables are: 



TABLE UTILITY 

B-l Library Maintenance 

B-2 Expand 

B-3 Autolink - Informational messages 

B-4 Autolink - Fatal errors 

B-5 Link 

B-6 Edit 
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B-l 



TABLE B-l. LIBRARY MAINTENANCE UTILITY ERROR MESSAGES 



Message Text 



AN ATTEMPT WAS MADE TO WRITE TOO MANY PROGRAMS 
TO THE NEW LIBRARY FILE 



DEL DIRECTIVE DOES NOT HAVE A MATCH ON THE 
OLD LIBRARY FILE 



I/O ERROR - READING INTERMEDIATE LIBRARY FILE 



I/O ERROR - READING LGO FILE 



I/O ERROR - READING OLD LIBRARY FILE 



I/O ERROR - WRITING INTERMEDIATE LIBRARY FILE 



I/O ERROR - WRITING NEW LIBRARY FILE 



NAME FIELD ON DIRECTIVE CARD IS NOT 
RECOGNIZABLE 



NEW LIBRARY ENTRY POINT TABLE OVERFLOW 



NO END-OF-TABLE WORD FOR ENTRY POINT TABLE 
RECORD ON LIBRARY FILE 

NO XFR BLOCK FOR PROGRAM ON RANDOM LGO FILE 



NON-ASCII (NOT $20-$5F) CHARACTER IN PROGRAM 
NAME OR ENTRY POINT ON THE LGO FILE 



PUT OR SUP DIRECTIVE DOES NOT HAVE A MATCH 
ON LGO FILE 



PUT OR SUP DIRECTIVE SECOND NAME DOES NOT HAVE 
A MATCH ON LGO FILE 



Meaning/User Action 



The library file is limited to 425 programs./ 
Delete nonused programs. 



The specified program (or the first program of a 
group) does not have a match on the old library 
file./ Check the object code module names against 
the directive parameter names. 



The intermediate file could not be read./ Try 
again. If error persists, call a system analyst. 



The LGO file is not in the proper format, or has 
been damaged./ Generate a new LGO file. 



The old library file is not in the proper format, 
or has been damaged. The old library cannot be 
used. 



The intermediate library file could not be 
written. The space for temporary files was 
exceeded, or there was an error in writing the 
file./ Return unused local files and try again; 
if second attempt fails, allocate more space for 
temporary files. 



The new library file could not be written. The 
file may be write-protected, or it could exceed 
the user's allocated file size, or there may be an 
error in writing the file./ Try again after 
checking protection of file. If error persists, 
call a system analyst. 



Program names consist of one to six letters, 
numbers, or $./ Check the directive name. 
Correct as appropriate. 



The total number of entry points plus programs 

(times 2) cannot exceed 4000./ Rewrite the 

programs to have fewer entry points or larger 
programs . 



The old library file is not in the proper format or 
has been damaged. The old library cannot be used. 



The LGO file is not in the proper format./ Try 
again. If error persists, call a system analyst. 



The LGO file is not in the proper format, or has 
been damaged./ Correct any format error; then try 



again . 



The specified program (or programs) does not have a 
match on the LGO file./ Check the object code 
module names against the directive parameter names. 



The name of the second program (mod 2) in a modl- 
mod2 parameter does not exist on the LGO file or 
it preceeds the first program name (modi)./ Check 
the order of modules in the LGO file. Use a 
different range of modules, or reverse the names 
in the parameter. 



B-2 
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TABLE B-l. LIBRARY MAINTENANCE UTILITY ERROR MESSAGES (Contd) 



Message Text 


Meaning/User Action 


PUT OR SUP SECOND NAME DOES NOT HAVE A MATCH 
ON OLD LIBRARY FILE 


The name of the second program (mod2) 
in a modl-mod2 parameter does not exist on the old 
library file or it preceeds the first program name 
(modi)./ Check the order of modules in the 
library. Use a different range of modules, or 
reverse the names in the parameter. 


TOO MANY PROGRAMS ON LGO FILE 


The LGO file is limited to 425 programs./ Delete 
nonused programs. 


UNRECOGNIZABLE DIRECTIVE 


The directive name is not *ALL, *PUT, *SUP, *DEL, 
or *LST./ Check the directives file, and enter a 
proper directive name. 



TABLE B-2. EXPAND UTILITY ERROR MESSAGES 



Message Text 


Meaning/User Action 


EMPTY MACRO CALL FILE 


An empty file was passed to Expand from the build 
procedures./ Notify a NOS system analyst. 


ERROR IN ASSOCIATED VARIANT DEFINITION 


/The user should correct the error in the USERBPS 
file, and rerun the build step. 


ERROR IN MACRO CALL FILE 


An erroneous file was passed to Expand from the build 
procedures./ Notify a NOS system analyst. 


ERROR IN MACRO TEXT FILE 


Probably a section of expected text was not found in 
the file. The file is generated from the EXPTEXT deck 
on the CCP program library./ Notify a NOS system 
analyst . 


ERROR IN USERBPS FILE 


/The user should correct the error in the USERBPS file 
and rerun the build step. 


INCOMPLETE SYMBOL 


An end-of-line was found before the delimiter in the 
USERBPS./ The user should correct the error in the 
USERBPS file, and rerun the build step. 


LINE TOO LONG AFTER SUBSTITUTION 


When the symbol was substituted in the text line, an 
overflow condition occurred. The file is generated 
from the EXPTEXT deck on the CCP program library./ 
Notify a NOS system analyst . 


NIL SYMBOL 


No characters were found before the delimiter in the 
USERBPS./ The user should correct the error in the 
USERBPS file, and rerun the build step. 


SYMBOL TOO BIG 


The character string had more than ten characters in 
the USERBPS./ The user should correct the error in 
the USERBPS file, and rerun the build step. 
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B-3 



TABLE B-3. AUTOLINK INFORMATIVE MESSAGES 



NOTE: 



Some Autolink messages are prefaced with one of two messages: 
***** ERROR ***** 
***** WARNING 



Message 



AIJTOLINK COMPLETED 



AUTOLINK OUTPUT DIRECTIVES LIST 



DELETED TOPHAT MODULE LIST 



EXCEEDS THE 18 COLUMN REPORT LIMITATION 



INVALID ADDRESS SPECIFICATION 



INVALID (C/NC/ ADDRESS) ATTRIBUTE 



INVALID LIST FILE 



INVAID MOD TERMINATOR 



INVALID OR MISSING LGO FILE 



INVALID P= PARAMETER 



INVALID SECONDARY BINARY FILE 



MORE THAN 60 APPLICATIONS DEFINED 



MORE THAN 60 DEF PARAMETERS 



MORE THAN 64 BUFSPSIZE PARAMETERS 



Mean ing/Act ion to be Taken 



Informative message only./ No action is required. 



Informative message only. This message is followed by the 
directives which serve as input to MPLINK./ No action is 
required. 



The listed modules had a tophat program that was deleted, 
since the modules were located in main memory rather than 
in paged memory./ No action; informative only. 



A BUFSP report has columns for all applications to be 
included in the build report, and for all the memory sizes 
to be tested. A maximum of 18 columns can be fit on the 
output report page. If the combination of APPL directives 
and BUFSPSIZE sizes exceeds 18, this message is 
generated./ Reduce the number of applications in the 
build, or reduce the number of memory sizes for the report. 



The address parameter in a MOD or RESERVE directive is not 
valid./ Use a legal address: addresses should be within 
memory size, and be expressed as a four-digit hexadecimal 
value starting with a dollar sign ($). 



While parsing an APPL directive, Autolink found an invalid 
address parameter, or the right parenthesis was missing./ 
Correct the invalid parameter. 



The list file is not named correctly, the first character 
of the name is not a letter, or the file is missing./ 
Correct the naming error, or make the file available. 



In a MOD directive, the terminator should be a comma 
except after modname (an opening parenthesis), or after 
the last appl value (a closing parenthesis)./ Correct the 
error . 



The load-and-go file is not named correctly, the first 
character of the name is not a letter, or the file is 
missing./ Correct the naming error, or make the file 
available. 



In the MOD directive, the P parameter must take the value 
of P, NP, F, or R./ Correct the error. 



The secondary binary file is not named correctly, the 
first character of the name is not a letter, or the file 
is missing./ Correct the naming error or make the file 
available. 



No more than 60 APPL directives are allowed./ Eliminate 
the unnecessary APPL directives. 



The combined number of DEF and DEFBASE directives exceeds 
60./ Eliminate the unnecessary directives. 



No more than 64 parameters can be associated with the 
BUFSPSIZE directive./ Eliminate the unnecessary 
parameters . 



B-4 
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TABLE B-3. AUTOLINK INFORMATIVE MESSAGES (Contd) 



Message 


Meaning/Action to be Taken 


MULTIPLE CORES IZE DIRECTIVES ENTERED 


Only one CORESIZE directive can be entered with an input 
directives file./ Select the correct CORESIZE directive 
for the file, and eliminate the others. 


NO APPLICATIONS GIVEN FOR THESE MODS: 


The list names the object code modules which have no 
corresponding application./ Correct the error. 


NO MOD DIRECTIVES FOR THESE OBJECT PGMS: 


The listed object code programs were found on the input 
object code file, but were not named in a MOD directive./ 
Check the names, and add MOD (and other) directives if 
these modules should be a part of the variant build. 


NON-NUMERIC (HEX) DIGIT 


A character is not recognized as a legitimate hexadecimal 
digit in one of the following directives: BUFSPSIZE, 
CORESIZE, PAGEREG, PAGESIZES, or RESERVE./ Correct the 
error and reenter the directive file. 


PAGE OVERFLOW FORCED BY USER 


The F parameter in the MOD directive forces an application 
length that requires more space than is allocated to the 
page./ Change F modules so that fewer are forced to the 
same page as their applications. 


REPORTS REQUESTED BUT NO LIST FILE GIVEN 


The output file for reports was not specified in the 
program name-call statement./ Correct the name-call 
statement to specify an output file for the reports. 


UNDEFINED APPLICATION NAME 


The appl name specified in the APPL parameter of the MOD 
directive was not specified in any APPL directive./ Use a 
correct APPL parameter, or enter the correct APPL 
directive. 



TABLE B-4. AUTOLINK FATAL ERROR MESSAGES 





NOTE: 

Fatal error messages are prefaced with the message 

EXECUTION TERMINATED DUE TO ERRORS 

**********FATAL ERRORS********** 


Message 


Meaning/Action to be Taken 


CORSIZE GREATER THAN 128 


Autolink detected a value greater than 128 in a 
CORESIZE or BUFSPSIZE directive./ Correct the invalid 
memory size parameter. 


EOF ENCOUNTERED, CONTINUATION EXPECTED 


Additional MOD parameters were expected (APPL is 
required; TH is required if P=P) . Instead, an EOF was 
detected in the directive./ Add the required 
parameter, or parameters, to the directive. 


INVALID DIRECTIVE TERMINATOR 


In a MOD directive, a comma or blank followed an 
application name, or a nonblank character followed the 
right parenthesis terminator./ Correct the error, and 
reenter the directive file. 


INVALID INPUT DIRECTIVE 


Format of input directive is not valid./ Correct the 
input directive, and reenter the directive file. 
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TABLE B-4. AUTOLINK FATAL ERROR MESSAGES (Contd) 



Message 



INVALID MOD NAME 



INVALID MOD SUBPARAMETER 



INVALID OR MISSING INPUT DIRECTIVES FILE 



INVALID OUTPUT DIRECTIVES FILE 



INVALID REPORT TYPE REQUEST 



INVALID RESERVE ADDRESS 



MAIN MEMORY EXCEEDED 



MODULE=xxxxx OVERLAPS ANOTHER MODULE 

or 
MODULE OVERLAP ERROR 



MORE THAN 32 PAGE SIZES 



NO MODS DEFINED FOR THESE APPLICATIONS 



NO OBJECT TEXT FOR THESE MOD DIRECTIVES: 

or 
NO OBJECT TEXT FOR THESE REQUIRED MODS: 



NON-MOD DIRECTIVE FOLLOWS MOD DIRECTIVE 



PAGE REGISTER GREATER THAN 31 



PAGE SIZE GREATER THAN 64 



Meaning/Action to be Taken 



While parsing a MOD directive, Autolink could not parse 
the modname parameter. A modname consists of six Cor 
more) characters starting with a letter./ Correct the 
error . 



In one of the parameters in a MOD directive, the 
parameter name is not correct (must be P, ADDR, FILL, 
TH, or APPL), or the = is missing, or a value is 
illegal./ Correct the error. 



The input directives file is not named correctly, the 
first character of the name is not a letter, or the 
file is missing./ Correct the naming error, or make 
the file available. 



The output directives file is not named correctly, the 
first character of the name is not a letter, or the 
file is missing./ Correct the naming error, or make 
the file available. 



An invalid report name was used in the RPT directive./ 
Use a valid name (BUFSP, DIR, MAP, or INFO). 



The beginning and ending reserve addresses should be 
separated by a comma./ Correct the error. 



The variant requires more then 64K words of main 
memory, or addresses are assigned which prevent the 
variant from being located within main memory./ Check 
applications that have preassigned addresses. Delete 
applications as necessary. 



When locating modules, Autolink detected that 
addressed module space overlapped into nonaddressed 
module space./ Adjust the lowest module address. 



More than 32 parameters were used in one PAGESIZES 
directive./ Use only one value per directive. 



This messages lists the APPL directives which have no 
MOD directives naming them in an APPL parameter./ 
Delete the APPL directives, or add MOD directives with 
these applications specified. 



This message lists modules which should have been 
present in the input object code file because they 
were specified by MOD statements./ Remove the MOD 
directives or include the object code for the modules 
in the input object code file. 



At this stage in the input directives file, there 
should be only MOD directives; all other directives 
should have occurred earlier in the file./ If the 
directive is valid, place it before the MOD directives. 



The page register parameter value in a PAGEREG 
directive is greater than 31./ Change the parameter to 
a legal value (range through 31). 



The pagesize parameter in a PAGESIZES directive is 
greater than 64./ Change the parameter to a legal 
value (2K, 4K, 8K, or 16K). 
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TABLE B-4. AUTOLINK FATAL ERROR MESSAGES (Contd) 



Message 


Meaning/Action to be Taken 


********WHILE LOADING FILLER MODULES 
nnn MODULES REMAIN UNLOADED 
xxxxxx 

xxxxxx 

INDEX J = iiii MODCNTR = iiii 
NEXTADR = hhhhh MAXADDR = hhhhh 


Either more modules are being loaded than are 
specififed by the MOD directive (index J is greater 
than the module counter), or more main memory is 
needed (next address is greater than maximum address ) . 
Names of the modules are given; nnn is a decimal 
number; hhhhh addresses are given in hexadecimal./ 
Correct the problem by retrying. If the build 
attempt still fails, contact a systems analyst. 



TABLE B-5. MPLINK ERROR MESSAGES 



Message 


Meaning/User Action 


*DAT AND GLOBL$ CONFLICT 


MPLINK encountered both a *DAT directive and an object code 
module called GLOBL$. The assigned GLOBL$ area exceeds the 
area assigned by the *DAT directive./ The user can remove the 
*DAT directive from the directives file , or he can increase the 
area assigned by the directive. 


*RL FORCES MOD BELOW ADDR 


The *RL directive causes MPLINK to locate some part of a module 
below the start of main memory./ The user should change the 
*RL directives. 


ADDRESS TABLE OVERFLOW 


The combined number of addresses specified in all the 
directives exceeds the maximum number permitted./ The operator 
should revise the directives, perhaps using directives with a 
range of items in the parameters such as *L , modi-mod 2, addr, 
rather than individual linking or reverse linking directives. 
This can require more than one library building operation, or a 
rearrangement of modules on the input object code file. 


ASSIGNEMENT OPERATOR EXPECTED 


The expression evalauator expected the := operator in the *VE 
directive but did not find one./ The users should correct the 
directive . 


BAD LGO OR NEWLIB FILE 


Either the input object code or the NEWLIB file is improperly 
formatted. An improper file may have been attached./ If this 
is not the case, the user may need to generate another input 
object code or NEWLIB file. 


COMMA EXPECTED 


The expression evaluator encountered a directive with fewer 
required parameters than expected./ The user should check the 
expression to assure that all the required parameters are 
present , and are separated from the previous parameter or 
directive name by a comma. 


COMMON AREA EXCEEDED 


MPLINK found a blank common specification in an object code 
module that exceeded the area allocated by the *COM 
directive./ The user should increase the size of the blank 
common area assigned by the *COM directive. 


CURRENT LOWER LIMIT EXCEEDED 


During linking caused by a *RL directive , MPLINK attempted to 
use a memory location below the word specified by the *LL 
directive./ The user should change the *LL boundary, or insert 
other directives to relocate the module (or group of modules) 
that crossed the boundary. 
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TABLE B-5. MPLINK ERROR MESSAGES (Contd) 



Message 


Meaning/User Action 


CURRENT UPPER LIMIT EXCEEDED 


During a normal loading caused by a *L directive, MPLINK 
attempted to use a memory location above that specified by the 
*UL directive./ The user should change the *UL boundary, or 
insert other directives to relocate the module (or group of 
modules) that crossed the boundary. 




DATA AREA EXCEEDED 


MPLINK found a named, common specification in an object code 
module that exceeded the area allocated by the *DAT 
directive./ The user should increase the size of the common 
area assigned by the *DAT directive, or decrease the number of 
applications used. 




DIRECTIVE TABLE OVERFLOW 


MPLINK encountered too many directives in the input directives 
file./ The user should consolidate directives (for instance, 
by using the directives with a range-type parameter such as 
modl-mod2). 




DUPLICATE ENTRY POINT 


The entry point or module name (or at least the first six 
characters of it) have been used in a previous entry point or 
module name./ The user should rename one of the two 
expressions to obtain a unique, six-character name. 




DUPLICATE LOADER MODULE 


MPLINK found at least two modules with the name LOADER./ The 
user should eliminate duplicate LOADER modules; he should 
retain only that module to be used at the head of the load file. 




ENTRY POINT TABLE OVERFLOW 


The combined number of entry point names, module names, and 
synonyms exceeded the entry-point table capacity./ The user 
could rewrite his programs to consolidate modules, or to use 
fewer *SYN directives. 




EXPRESSION TABLE OVERFLOW 


The number of expressions appearing in the *VE directives 
exceeds the allowable maximum./ The user should use fewer *VE 
directives, and revise the input modules accordingly. 




EXPRESSON VAL EXCEEDS $3FFF 


The value encountered in a *VE directive is too large (value 
range is to $3FFF)./ The user should change the directive. 




EXT IN EXPR NOT ABSOLUTIZED 


An entry-point name (naml or nam 2) appearing in a *VE directive 
has not been previously absolutized./ The user should alter 
the *VE expression, or the order in which directives are added, 
so that the name is absolutized by the time MPLINK encounters 
the *VE directive. 




EXPRESSION OPERAND STACK OVERFLOW 


The expression evaluator found too many operands during its 
processing./ The user should restate the expression with 
additional, nested parenthesis groupings. 




IDENTIFIER EXPECTED 


A valid name is expected in a *ENT, *OVLY, or *SYN expression, 
and it was not supplied./ The user should insert a valid name 
(a letter followed by a string of letters and/or digits) at the 
appropriate place in the directive. 




ILLEGAL DIRECTIVE 


The keyword that names the directive is incorrect./ The user 
should reenter the directive with the correct keyword. 




ILLEGAL EOF ENCOUNTERED 


A temporary MPLINK work file encountered an unexpected 
end-of-file. This is an internal error./ Rerun MPLINK. 




ILLEGAL SYMBOL 


The expression evaluator found a symbol it could not 
interpret./ The user should check the directive for symbols 
that are not in the 63 or 64-character display code set (as 
appropriate) . 
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TABLE B-5. MPLINK ERROR MESSAGES (Contd) 



Message 


Meaning/User Action 


INCORRECT GROUP SPECIFICATION 


The module names specified by the modl-mod2 parameter in a *L 
or *RL expression are not correct; that is, modi, mod 2, or both 
are incorrectly specified. The user should reenter the 
directive with the correct module names as they appear on the 
input object code or NEWLIB files. Alternatively, an incorrect 
module name on those files should be changed. 


INVALID ADDRESS (COMPONENT) 


A directive has an invalid addr , or some component of an addr 
is in error. The user should correct the address and reenter 
the directive. 


LOGICAL ADDRESS EXCEEDS $FFFF 


An object code module is longer in 64K words and cannot be 
fitted in the NPU./ The module should be divided into smaller 
modules, or rewritten to reduce the number of words. 


MAXIMUM GROUP SIZE EXCEEDED 


In a range-type parameter (modl-mod2), the number of modules, 
or the number of words in all of the modules, exceeds MPLINK' s 
ability to process the group./ The user should split the range 
parameter between two or more directives, each with a smaller 
modi-mod 2 size. 


MEMORY OVERFLOW 


MPLINK assigned memory locations that do not exist in the 
NPU./ The user should check the memory size assigned by the 
*COR directive. If it is correct, the user can try reassigning 
the link start locations. It is possible that there is not 
enough memory for all the planned applications. The user could 
remove some applications; alternatively, additional memory 
should be purchased. 


MISSING LEFT OR RIGHT PAREN 


The expression evaluator found one of two errors: a left 
parenthesis not followed by a right parenthesis, or a right 
parenthesis that was not preceded by a left parenthesis./ In 
either case, the user should modify the expression to include 
the missing parenthesis, or to delete the unwanted parenthesis. 


MOD ON LINK DIR NOT FOUND 


The module specified by the mod parameter in a *L or *RL 
directive could not be found on the input object code or 
library file./ The user should check the module name and 
correctly specify it, or add the missing module to the 
appropriate file. 


MODULE TOO LARGE 


The specified module exceeds the size of MPLINK' s external 
buffer./ The user should recode the module to compress it, or 
divide the module into two or more modules. 


OPERAND EXPECTED 


The expression evalauator expected an numeric value operand./ 
The user should revise the statement. 


OVERLAY AREA LEN LESS THAN 


In an OVLY directive, the ending address (addre) parameter is 
smaller than the beginning address (addrb) parameter./ The 
user should check the limits of the desired overlay size, and 
enter the proper limits. 


OVERLAY AREA TABLE OVERFLOW 


Only ten overlay areas can be declared with *OVLY directives./ 
The user should rearrange his applications so that no more than 
ten of them use overlays . 


PERIOD EXPECTED 


The expression evaluator expected the directive to be 
terminated with a period but found another * instead./ User 
should check to assure the directive is properly terminated 
with a period. 


PLUS, MINUS, OR PERIOD EXPECTED 


In a variable directive (*VE), the expression evaluator 
expected a plus, a minus, or a period in the exp parameter. 
None of these was found./ The user should enter the correct 
expression in the directive. 
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TABLE B-5. MPLINK ERROR MESSAGES (Contd) 



Message 


Meaning/User Action 




SYNONYM TABLE OVERFLOW 


Too many *SYN directives were entered./ The user should revise 
his programs so he will have to declare fewer of these 
name-equating operations. 




TOO MANY LOCAL VARIABLES 


Too many variables were declared by *VE directives./ The user 
should recede to use fewer local variables. 




UNDEFINED OR ILLEGAL INDENT 


The name of an overlay is being illegally defined, or the 
referenced name of an entry point in a *SYN or *ENT directive 
is missing./ The user should use a correct overlay identifier 
(range AA through ZZ), or should enter the correct entry-point 
name on the *SYN or *ENT directive. 




UNSATISFIED EXT TABLE OVERFLOW 


MPLINK has encountered too many unsatisfied external 
references, or forward external references. The user should 
rearrange module sequencing to minimize forward references, or 
he should delete some of the unsatisfied external references. 

_ _ 





TABLE B-6. MPEDIT ERROR MESSAGES 



Message 


Meaning/Programmer Action 


( EXPECTED 


MPEDIT syntax requires that the next element of the statement 
be an opening parenthesis./ The programmer should revise the 
statement. 


) EXPECTED 


MPEDIT syntax requires that the next element of the statement 
be a closing parenthesis./ The programmer should revise the 
statement . 


[ EXPECTED 


MPEDIT syntax requires that an array statement has the form: 
ARRAY size OF x. The array statement lacks the opening 
square bracket around the size parameter./ The programmer 
should revise the composite statement. 


] EXPECTED 


MPEDIT syntax requires that an array statement has the form: 
ARRAY size OF x. The array statement lacks the closing 
square bracket around the size parameter./ The programmer 
should revise the composite statement. 


**** OUT OF RANGE 


This occurs only in a trace listing. The previous statement 
referenced an address that does not exist in the load file./ 
The programmer should revise the statement . 


:= EXPECTED 


MPEDIT syntax requires that the next element of the statement 
be a defining operand./ The programmer should revise the 
statement . , 


; EXPECTED 


MPEDIT syntax requires that this statement or declaration be 
separated from the previous statement or declaration by a 
semicolon./ The programmer should revise the statement. 


= EXPECTED 


MPEDIT syntax requires that the next element of the constant 
definition be an equal sign./ The programmer should revise the 
statement. 


xxxxxx MULTIPLE ENTRY DEFINITION 


A local symbol, array name, or overlay name has been defined 
more than once, xxxxxx is the multiply defined name./ The 
programmer should redefine one of the names, keeping in mind 
that only the first six characters of the name are unique as I 
far as MPEDIT is concerned. | 
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TABLE B-6. MPEDIT ERROR MESSAGES (Contd) 



Message 



Meaning/Programmer Action 



ARRAY TABLE OVERFLOW 



The number of arrays declared in the ARRAY section exceeds the 
capacity of MPEDIT./ The programmer show revise his program to 
include fewer arrays . 



BEGIN EXPECTED 



MPEDIT syntax requires that a composite statement begin with 
the keyword BEGIN./ The programmer should revise the composite 
statement . 



COMMA EXPECTED 



MPEDIT syntax requires that parameters in /VFD expressions and 
array expressions be separated by commas./ The programmer 
should revise the statement. 



DIMENSION TABLE OVERFLOW 



The total number of dimensions declared for all arrays within 
the ARRAY section exceeds the capacity of MPEDIT./ The 
programmer should revise his programs to include fewer arrays, 
or reduce the dimensions in the exis ting arrays . 



DO EXPECTED 



MPEDIT syntax requires that a FOR - TO statement be followed 
with the keyword DO./ The programmer should revise the 
statement. 



END EXPECTED 



MPEDIT syntax requires that a composite statement terminate 
with the END keyword./ The programmer should revise the 
composite statement. 



EXPRESSION OPERAND STACK OVERFLOW 



The expression evaluator encountered too many operands during 
evaluation./ The programmer can usually avoid this problem by 
revising the statement with additional , nested parenthetical 
groupings . 



ILLEGAL ARITHMETIC OPERATOR 



The expression evaluator expected one of the five legal 
arithmetic operators: +, -, *, DIV, or MOD./ The programmer 
should revise the statement. 



ILLEGAL END 



The keyword END is not permitted where it was found./ The 
programmer should eliminate END from this position in the 
program. 



ILLEGAL KEYWORD 



The only keywords recognized by MPEDIT are: 



CONST 


VAR 


ARRAY 


BEGIN 


END 


OVERLAY 


FOR 


TO 


DO 


OF 


CHAR 


DIV 


MOD 







The keyword found is not one of these./ The programmer should 
change the program to use the desired legal keyword. 



ILLEGAL SYMBOL IN EXPRESSION 



The expression evaluator encountered a symbol that was not in 
the CDC 63 or CDC 64 display code set (as appropriate)./ The 
programmer should remove the undefined symbol, and substitute a 
symbol defined in the proper character set. 



ILLEGAL DIMENSION COUNT 



The number of index values specified for an array in the 
assignment section does not agree with the number of values 
declared in the array declaration section./ The programmer 
should revise the program to make the index values agree. 



MISSING RIGHT PARENTHESIS 



The expression evaluator found a left parenthesis that was not 
followed by a right parenthesis./ The programmer should modify 
the expression to include a right parenthesis, or to delete the 
left parenthesis. 
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TABLE B-6. MPEDIT ERROR MESSAGES (Contd) 



Message 


Meaning/Programmer Action 




HO ASSOCIATED LEFT PARENTHESIS 


The expression evaluator found a right parenthesis that was not 
preceeded by a left parenthesis./ The programmer should modify 
the expression to include a left parenthesis, or to delete the 
right parenthesis. 




NOT A LOCAL VARIABLE 


The indicated local identifier was not previously specified in 
the VAR section./ The programmer should either declare the 
variable in the VAR section, or specify an already declared 
variable. 




OF EXPECTED 


MPEDIT syntax requires that an array statement has the form: 
ARRAY size OF x. The array statement lacks OF following the 
array size specification./ The programmer should revise the 
composite statement . 




OPERAND EXPECTED 


The expression evaluator expected an numeric value operand./ 
The programmer should revise the statement. 




OUT OF RANGE 


The array index is not within the range declared for the array 
in the ARRAY section./ The programmer should either increase 
the declared range, or revise the erroneous statement. 




PERIOD EXPECTED 


The program ends with a period after the final END statement. 
None was found./ The programmer should revise the composite 
statement. 




STUFF TABLE OVERFLOW 


The number of editing values exceeds the internal capacity of 
MPEDIT./ The programmer can present the editing information in 
successive runs, recalling MPEDIT for each new section of the 
editing operation. 




TO EXPECTED 


MPEDIT syntax requires that a FOR statement be followed with 
the keyword TO./ The programmer should revise the composite 
statement . 
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GLOSSARY AND MNEMONICS 



Absolute Address (NPU) - 

The location of a word in NPU memory measured by 
its displacement from word 0. 

Application (CCP or CCI) - 

A set of modules which are designed to be executed 
together to perform a special function. In CCP and 
CCI, applications include a HIP, a LIP (CCP only), any 
of the standard or user-written TIPs, the base modules, 
initialization routines, interactive virtual terminal 
common routines (CCP only), on-line diagnostics, the 
buffer space, the service module, and the test utilities. 

Assignment Section - 

The part of the MPEDIT program that contains the 
statements which assign values to variables or fields. 

Autolink - 

A CYBER Cross utility program which generates an 
input directives file for the MPLINK utility. 

Base - 

A set of programs that is used in every CCP or CCI 
build. 

Blank Common - 

A common area used by macroassembler programs. 

Buffer Space Report - 

An optional autolink output. It reports the amount of 
buffer space available as a function of the main 
memory size, and the TIPs selected for a build. 

Build - 

The procedure of converting individual source code 
modules into a linked set of object code modules in the 
form of a load tape. 

Directive - 

A utility input statement specifying some utility 
operation. 

Directives Report - 

An autolink report which lists the directives in the file 
that is sent to MPLINK. 

Dump Memory - 

A hexadecimal listing of the memory image load 
module file produced by MPLINK. 



Dynamic Variable Area - 

An area used by the PASCAL NEW procedure. 
PASCAL Compiler Reference Manual. 



See the 



Edit Utility - 

The utility (MPEDIT) which allows the user to 
initialize values in the memory image load file. The 
initialized memory image load file produced by the 
Edit utility can be converted into an NPU load file. 

Entry Point - 

A labeled statement in a module which other modules 
can reference. In some cases, another program can 
activate a module at the entry point. 



Error Messages - 

Messages generated by a utility specifying operations 
which the utility could not perform. The failure could 
be due to a syntax error, an overflow condition, or 
other fault. Error messages are usually sent to the 
output file. Error messages are of two types: fatal 
errors that halt the utility, and nonfatal errors that 
are noted, but allow the utility to continue processing. 

Expand - 

The build utility that expands variant- definitions into 
directives for the CCP variant build and load file 
generator installation steps. 

External Synonyms - 

Statements equating module names and entry points 
with local names. 

Fatal Error File - 

An autolink file containing the fatal error message 
generated during an autolink processing phase. 

Field - 

A sequence of continuous bits consistently used to 
record similar information. For CCP and CCI, fields 
range from 1 to 16 bits in length, and cannot cross 
word boundaries. 

Fill Module - 

A module that can be assigned to fill holes in main 
memory, or (in some cases) to fill a hole on a page. 



Forced Page Module - 

A module that must reside on 
paged portion of its application. 



the same page as the 



Information Report - 
An autolink report 
application lengths. 



listing the input directives and 



Initialized Load File - 

The load file that is generated by MPEDIT. It has the 
same format as the MPLINK load file; however, 
selected fields and variables have initial values. 

Installation Procedures - 

The CCP or CCI procedures that generate a load file, 
which can be immediately downloaded into an NPU to 
form the on-line system of that NPU. 

Input Directives File - 

A file containing the directives necessary to execute 
the autolink, MPLINK, MPEDIT or MPLIB utilities. 

Keyword - 

A reserved word used by a utility for a specific 
operation. 

LGO File - 

The load-and-go file. The file with this local name 
contains relocatable object code modules. 
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Library - 

A group of object code modules, together with an 
index for those modules. The old library can be used 
an an input to the autolink, MPLINK, MPEDIT and 
MPLIB utilities. The MPLIB utility generates a new 
library. 

Library File - 

A file created by MPLIB. The file contains object 
code for ail modules in the library, plus an index to the 
modules. 

Library Maintenance - 

The function performed by MPLIB utility; that is, 
generating a new library from a set of object code 
modules, or generating a new library from the old 
library, together with selected new object code 
modules. 

Link Utility - 

The utility (MPLINK) which links object code modules 
into into a memory image load module. MPLINK also 
produces a symbol table file. Both of these files are 
used as input for the Edit utility. 

Linking - 

The process of (1) locating (assigning space) for object 
code modules on a memory image load module file, and 
(2) resolving external calls in those modules with entry 
points in other load file modules. 

Listing File - 

A utility output file. In most cases it contains user 
requested reports. 

Load File - 

The host file holding a set of linked, edited, 
absolutized object code modules. The file can be 
downline-loaded into a specific NPU to form the 
on-line system for that NPU. A different load file 
(variant) is needed for each NPU to be loaded. 

Memory Image Load Module File - 

A file produced by the MPLINK utility. The load 
module file contains the absolutized code for all 
programs to be used in the CCP or CCI build. 
MPLINK's version of this file is not initialized; 
MPEDIT initializes the file. A host load file generator 
converts the initialized memory image load module 
into a load file for CCP or CCI. 

Memory Map - 

An autolink or MPLINK report showing the main 
memory location of every module in the build. 

MOD Directive - 

An autolink directive which identifies a module to be 
included in an application package. 

Modname - 

The name of a module. Autolink uses the first six 
characters of the name. 

Module - 

(1) An integral part of an application that has a name 
and at least one entry point (a module is sometimes 
called a routine or a program). Any module can be 
selected to be used as part of an NPU build. 

(2) See memory image load module file. 

MPEDIT - 

The editing utility that assigns values to variables in 
the memory image load module file generated by 
MPLINK. 



MPLINK - 

The utility that assigns space to modules on a memory 
image load module file, and links the modules together 
by equating external calls in one module to the 
comparable entry point in another module. 

Name Call Statement - 

The statement that is executed by the host's operating 
system to pass control of the computer to the program 
(or utility) associated with that statement. 

Object Code Input Files - 

Input files containing modules in object code format. 
Such files are used in all the utilities except the 
expand utility. 

Object File - 

A utility input or output file containing object code for 
modules. 

Output Directives - 

An autolink output file containing the MPLINK 
directives used to link the system modules during an 
MPLINK run. 

Overlay - 

A set of modules (application) that is not normally 
resident in the NPU. When the overlay is to be 
executed, it is loaded into a specific overlay area. The 
modules which normally use that area cannot be used 
until the overlay is ejected. 

Overlay Area - 

The part of an NPU that can be used to execute 
overlay programs. 

Package (CCP or CCI) - 

A special class of applications that handle terminal, 
host or link interfaces; for example, the terminal 
interface packages (TIPs). 

Page (logical) - 

An 8196-word section of CCP or CCI memory. All 
memory is paged. Memory up to 65K is executable at 
the address given; memory above 65K is imaged at the 
page beginning at 2000ig. 

Page (physical) - 

A 2K (2048) word section of NPU memory. 

Page Addressing - 

The method of using an 18-bit address to locate a 
module that is assigned to a pageable area of memory. 
All modules assigned to the region above 65K are 
accessed in page-addressing mode. Some of the area 
below 65K is also page-addressed. In particular, in 
CCP and CCI, an 8K page starts at address 2000ig. 
All modules paged above 65K are imaged at this page. 

Page Register - 

A register that indexes one of the NPU physical pages. 

Pageable Module - 

A module that can be located on the application page, 
or in main memory if the application's page is full. 

Passive MPLINK Directives - 

Directives not processed by autolink, but passed 
directly to MPLINK in the output directives file. 
These are : *COM, *COR, *DAT, *DSTK, *DMP, 
♦DVAR, *ENT, *LIB, *SYN, and *SYSID. 

Program - 

A module or a group of modules with related functions. 
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Report - 

One of the reports that is associated with the 
Autolink, Link, Edit, or Library Maintenance utility 
programs. 

Reverse Loaded - 

A module that is located in main memory by assigning 
the address given to the last word of the module. 
Space is then reserved for all other words in the 
module down to the first word. 



Stack Area - 

A reserved area in an NPU memory 
PASCAL recursive /reentrant procedures. 



for use by 



Terminal Interface Package (TIP) - 

An application that handles the interface between the 
NPU and a type of terminal, such as TTY terminals, or 
Mode 4 terminals. 

Tophat - 

Indicates a tophat module. A tophat module is 

normally a module that is called by several other 

modules. To minimize the code required to locate a 



tophat module's entry point, a small auxiliary piece of 
code is compiled with the module. This tophat code 
sets the page registers when other modules call this 
module. If a tophat module is located in a main 
memory, this operation is not necessary, so the tophat 
auxiliary code is discarded. Otherwise, if a tophat 
module is paged, the tophat code is located in main 
memory to set the page registers. 

User Build Parameters File - 

A user file (USERBPS) which contains the CCP variant 
load module definitions and the CCP load file 
definitions. Expand uses the file to generate Update 
directives based on the variant definition. 

Variant - 

The definition of a real set of hardware and software 
for an NPU. The variant for an NPU defines the 
memory size, the NPU type (local or remote), the TIPs 
to be included in the build, and the maximum number 
of lines that can be configured. The variant also 
identifies the NPU, the host coupler (if any), and any 
trunks used by the NPU. 
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MNEMONICS 



*ALL Copy all LGO files to new library - MPLIB 

directive 

♦CB Upper boundary declaration - MPLINK 

*COM Define blank common area - MPLINK directive 

*COR Define 255x memory size - MPLINK directive 

*DAT Define labeled common area - MPLINK 

directive 

♦DEL Delete module - MPLIB directive 

*DMP Define labeled common area - MPLINK 

directive 

♦DSTK Define stack area - MPLINK directive 

*DVAR Define stack area - MPLINK directive 

♦END End-of-directive-file directive - all build 

utilities 

*ENT Define entry point - MPLINK directive 

*L Link modules - MPLINK directive 

*LIB Define library file - MPLINK directive 

*LL Lower boundary declaration - MPLINK 

♦LST List the library - MPLIB directive 

*OVLY Define overlay-area directive - MPLINK 

♦PUT Insert/replace module in library - MPLIB 

directive 

♦RL Reverse-linking directive - MPLINK 

♦SUP Suppresses copying programs from the LGO 

to the library - MPLIB 

♦SYN Define external synonym - MPLINK directive 

♦SYSID System identification - MPLINK directive 

♦UL Upper limit directive - MPLINK 

*VE Directive which assigns a value to a local 

variable - MPLINK 

/DMP$ List the load tape - MPEDIT statement 

/ENTRY Address entry function - MPEDIT statement 

/ESL$ List SYMTAB - MPEDIT statement 

/LENGTH Field length function - MPEDIT statement 

/NAM$ Generate the NPU load tape - MPEDIT 

statement 

/PGDISP Page displacement function - MPLINK/ 
MPEDIT statement 



/PGNUM Page resister number function 
MPLINK/MPEDIT statement 

/PGSET Page register set function - MPLINK/MPEDIT 

statement 

/START Field state location function - MPEDIT 
statement 

/TRACE Trace of edit operations - MPEDIT statement 

/VFD Variable field definition - MPEDIT statement 

ABSOLMP Absolute memory image load file 

ARRAY Array declaration command - MPEDIT 

BEGIN Begin statement - MPEDIT 

BIP Block interface package 

BUFSIZE Buffer space report directive - Autolink 

BUFSP Buffer space report - Autolink 

CCP Communications Control Program 

CHAR Character mode, array declaration - MPEDIT 

CONST Constant declaration - MPEDIT 

CORESIZE NPU memory size directive - Autolink 

CSET CDC code set variable 

D Input file parameter - MPLINK directive 

DEF Define applications - Autolink directive 

DEFBASE Define applications variant - Autolink 
directive 

DIR Output directives report - Autolink directive 

DIV Division operator - MPEDIT 

DO Part of MPEDIT loop directive (FOR x TO y 

DO...) 

END End statement of a composite statement - 

MPEDIT 

FOR Part of MPEDIT loop directive (FOR x TO y 

DO...) 

GLOBL$ CCP/CCI data base area 

HIP Host interface package 

INFO Input directives and application lengths report 

INPUT Default input file 

LFG Load file generator - Expand 

LGO Load-and-go file 

LIP Link interface package 
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LOADER First record on a memory image load module 
tape 

MAP Main memory map report - Autolink 

MOD Module directive - Autolink 

MOD Modulus operator - MPEDIT 

MPEDIT Edit utility 

MPLIB Library maintenance utility 

MPLINK Link utility 

NEWLIB New library file - MPLIB 

OF Part of array declaration - MPEDIT 

OUTPUT Default output file 

OVERLAY Overlay identifier - MPEDIT 



PAGESIZES Page size directive - Autolink 

RESERVE Reserve main memory - Autolink directive 

RPT Report generator directive - Autolink 

SVM Service module 

SYMTAB Symbol table file 

TIP Terminal interface package 

TO Part of MPEDIT loop directive (FOR x TO y 

DO...) 

USERBPS User build parameters file - Expand 

VAR Variable declaration - MPEDIT 

VRD CCP variant definition - Expand 

X.25 A TIP 
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MEMORY IMAGE LOAD MODULE FILE FORMAT 



This appendix describes the format of the memory image 
load module file. It is an output of either MPLINK or 
MPEDIT. The only difference between the two files is the 
initialization of certain values. Format of the files is 
identical. 



System Header Record 

Figure D-2 shows the format of the system header 
record. This record is generated as the direct result of 
the MPLINK directive: *SYSID,name(,text). 



MPLINK or MPEDIT builds the load module file from 
object code programs and directives. The object code 
programs can be on an LGO file or a library file, or, for 
MPEDIT, a non-initialized memory image load module file 
produced by MPLINK. If the object code programs are on 
an input object code file, they have been previously 
produced individually by a CYBER Cross macroassembler, 
microassembler, or PASCAL compiler. Libraries, 
likewise, are composed of object code programs produced 
by these CYBER Cross compilers/assemblers. A library 
has a directory for locating the modules easily. 

Each program on the load module file has an execution 
(load) address. This address is either specified, or equated 
to zero, by the MPLINK utility. External references from 
all programs can be resolved from a program library. The 
user can also specify entry-point values (addresses). 



FILE FORMAT 

Figure D-l shows the load module file format on the 
highest level. On this level, the file consists of an 
optional loader record, a partition for NPU-resident 
programs, and partitions for each group of overlay 
modules (assuming there are any optional overlays). The 
resident load partition includes a system header record 
followed by a series of record pairs, one pair for each 
program in the on-line system. If there are overlay 
partitions, each of these has a format similar to that of 
the resident partition. The file is terminated with a 
trailer record. 



OPTIONAL LOADER RECORD 

If the LOADER record exists, it is the first record on the 
load module file. This record is included only if an object 
text file called LOADER is included in the library or input 
object code files used as input by MPLINK. Format of 
this header record is arbitrary. 



RESIDENT LOAD PARTITION 

This partition contains object code for every module in 
the on-line NPU system. It does not contain any code for 
overlay modules. 

The partition has a system header, followed by a record 
pair far every on-line module. The modules occur in the 
same order in which they occur in NPU memory. 

A record pair for a module consists of a module header 
record followed by a record containing the object code for 
the module. 



In this 30-word record the fields are: 

• RECORD COUNT (word 1) is the number of 
records in the resident partition. The number of 
modules in this partition is: 

Number(modules) = (records - l)/2 

■ HEADER TYPE (word 2) is a system header (type 
= 0). 

• MEMORY ADDRESS (words 2 and 3) is not used. 

• NAME (words 4, 5, and 6) is the six-character 
ASCII identifier specified by the name parameter 
in the *SYSID directive. 

• TEXT (words 7 through 30) is specified by the text 
parameter in the *SYSID directive. Character 
code is ASCII. Any characters not used are filled 
with zeros. 



Module Header Record 

Figure D-2 shows the format of the module header 
record. This record is generated by MPLINK at the time 
modules are linked as the result of a *L or *RL directive. 

In this 30-word record the fields are: 

• WORD COUNT (word 1) is the number of 16-bit 
words of object code in the following record. 

• HEADER TYPE (word 2) is a module header (type 
= 4). 

• MEMORY ADDRESS (words 2 and 3) designates 
the address of the module's first word. It has 
three parts (see page addressing description in the 
MPLINK section): 

PAGE NUMBER is the 7-bit logical page 
number. 

PAGE REGISTER is the 5-bit page register ID. 

PAGE DISPLACEMENT is the 11-bit 
displacement (in words) to the first word of 
the module on the physical page. 

■ NAME (words 4, 5, and 6) is a six-character ASCII 
identifier. It has one of the following formats: 

A PASCAL common area name: MAIN$ or 
GLOBL$ 
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FILE FORMAT 




LOADER RECORD 
(OPTIONAL) 




END OF RECORD 


RESIDENT LOAD 
PARTITION 




RESIDENT 

LOAD 

PARTITION 




SYSTEM HEADER 
RECORD 


LOAD PARTITION 


LOAD 
PARTITION 




MODULE 1 
HEADER RECORD 








END OF RECORD 


END OF RECORD 


OVERLAY AREA 


LOAD PARTITION 




MODULE 1 
MEMORY IMAGE 
RECORD 


OVERLAY 
AREA 1 
LOAD 
PARTITION 


«. J 


OVERLAY AREA 
HEADER RECORD 




END OF RECORD 


END OF RECORD 


OVERLAY 1 
HEADER RECORD 


MODULE 2 
HEADER RECORD 


END OF RECORD 


END OF RECORD 


END OF RECORD 


• 
• 
• 
• 


OVERLAY 
IMAGE BLOCK 
(OVERLAY 1) 


MODULE 2 
MEMORY IMAGE 
RECORD 


OVERLAY 
AREA m 
LOAD 
PARTITION 




END OF RECORD 


END OF RECORD 


• 
• 
• 
• 


• 
• 
• 
• 


END OF RECORD 


OVERLAY m 
HEADER RECORD 


MODULE n 
HEADER RECORD 


TRAILER 
RECORD 








END OF RECORD 


1 END OF FILE 




MODULE n 
MEMORY IMAGE 
RECORD 







M-1095 



Figure D-l. Format of an MPLINK or MPEDIT Output Load File 



The name associated with a PASCAL- 
compiled program 

The name specified on the NAM card of a 
macroassembled program 

The name of a microassembled program 

COMMENTS (words 7 through 30) is blank if this a 
PASCAL-compiled module. It is the comment (in 
ASCII characters) on the NAM card if this is a 
macroassembled module. 



Resident Module Record 

This record consists of 16-bit words of object code. 

OVERLAY LOAD PARTITION 

There can be one to ten overlay partitions. Each partition 
is separately identified, and occurs in the same order that 
the overlay directives were entered in MPLINK. 

An overlay partition contains object code for every 
module in that overlay. 



The partition has an overlay header, followed by a record 
pair for every module in the overlay. The modules occur 
in the same order in which they occur in NPU memory 
when the overlay is moved into its execution area. 

A record pair for an overlay module consists of an overlay 
module header record followed by a record containing the 
object code for the overlay module. 



Overlay Area Header Record 

Figure D-2 shows the format of the overlay area header 
record. This record is generated as the direct result of 
the MPLINK *OVLY directive. 

In this 30-word record the fields are: 

• RECORD COUNT (word 1) is the number of 
records in this overlay partition. The number of 
overlay modules in this partition is: 

Number(modules) = (records - l)/2 

• HEADER TYPE (word 2) is an overlay area header 
(type = 1). 
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BIT 
WORD 5 14 



11 10 



76 



WORD OR RECORD COUNT 




CHAR 3 NAME CHAR 4 



CHAR 5 



CHAR 1 



CHAR 6 



30 



TEXT, COMMENTS, 
OR ZEROS 



PAGE FIELDS 
COLLECTIVELY 
ARE THE 
MEMORY 
ADDRESS 



CHAR 48 



HEADER TYPE (3 BITS) 

- SYSTEM (RESIDENT PARTITION) 

1 - OVERLAY PARTITION 

2 - OVERLAY MODULE 

4 • RESIDENT MODULE 

NOTE; THE LENGTH OF THE WORD IS ASSUMED TO BE 
16-BITS (THE WORD SIZE OF THE TARGET NPUI 
RATHER THAN 60 BITS (THE WORD SIZE OF THE 
HOST COMPUTER GENERATING THE LOAD MODULE 
FILE). M-1088 

Figure D-2. Format of Load File Header Record 



MEMORY ADDRESS (words 2 and 3) specifies the 
first word of the overlay area. It has three parts: 

PAGE NUMBER is the 7-bit logical page 
number. 

PAGE REGISTER is the 5-bit page register ID. 

PAGE DISPLACEMENT is the 11-bit 
displacement (in words) to the first word of 
the module on the physical page. 

NAME (words 4, 5, and 6) is the six-character 
ASCII identifier specified by the name parameter 
in the *SYSID directive. 

TEXT (words 7 through 30) is not used. Characters 
are filled with zeros. 



Overlay Module Header Record 

Figure D-2 shows the format of an overlay module header 
record. This record is generated by MPLINK at the time 
modules are linked as the result of a *L or *RL directive 
following an overlay declaration. 

In this 30-word record the fields are: 

• WORD COUNT (word 1) is the number of 16-bit 
words of object code in the following record. 

• HEADER TYPE (word 2) is an overlay module 
header (type = 2). 




DYNAMIC 
VARIABLE 
AREA (BEGIN) 



DYNAMIC 
VARIABLE 
AREA (END) 



BIT 15 IN WORD 2 SET INDICATES THE 
TRAILER RECORD. THIS BIT IS IN A 
HEADER RECORD. 

NOTE: THE LENGTH OF THE WORD IS ASSUMED TO BE 
16-BITS (THE WORD SIZE OF THE TARGET NPU) 
RATHER THAN 60 BITS (THE WORD SIZE OF THE 
HOST COMPUTER GENERATING THE LOAD MODULE 
FILE). M-1091 

Figure D-3. Format of Load File Trailer Record 



• MEMORY ADDRESS (words 2 and 3) specifies the 
address of the overlay module's first word when it 
is in NPU memory. The address has three parts: 

PAGE NUMBER is the 7-bit logical page 
number. 

PAGE REGISTER is the 5-bit page register ID. 

PAGE DISPLACEMENT is the 11-bit 
displacement (in words) to the first word of 
the module on the physical page. 

■ NAME"(words 4, 5, and 6) is a six-character ASCII 
identifier. It is the name associated with a 
PASCAL-compiled program. 

• COMMENTS (words 7 through 30) is blank. The 
characters are filled with zeros. 



Overlay Module Record 

This record consists of 16-bit words of object code. 

TRAILER RECORD 

The format of the trailer record is shown in figure D-3. 
The use of the words is described on that figure. 
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OPTIONAL MEMORY IMAGE LOAD MODULE FILE FORMAT 



The optional memory image load file for an NPU consists 
of a single record. The file is generated by the 
pseudoconstant /NAM$ in the MPEDIT utility. 

The record begins with a prefix and a header as shown in 
figure E-l. The data within the record is segmented. 
Each segment is preceded by the first word address (FWA) 
for which it is intended. Each segment is also preceded by 
a length field. The length field indicates the number of 
16-bit words in the data segment. The length can never 
exceed 120 16-bit words. 

The prefix is shown in figure E-2. It contains information 
describing the creation of the record. Except for the first 
60-bit word and the binary zero fill in the second 60-bit 
word, all information in the prefix is in display code, with 
blank fill, so that it can be printed. The prefix contains 
exactly 15 60-bit words. 

The header is one 60-bit word. It contains the record 
name in display code, in bit positions 59 through 42. The 
bit pattern of the remainder of the word is shown in figure 
E-3. 

The first word address and the length field formats are 
shown in figure E-4 and E-5. 

The data segment format is shown in figure E-6. 



59 



47 41 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 



35 



29 23 



17 



7700 8 



00168 



RECORD 
NAME 



DATE 



TIME 



OPERATING SYSTEM NAME 



OPER. SYS. VERS. 



LANGUAGE PROCESSOR NAME 



LANG. PROC. MOD. LEVEL 



LANG. PROC. VER. 



BLANK FILL 



BLANK FILL 



LANGUAGE PROCESSOR INFORMATION 

OR 

BLANK FILL 



USER COMMENTS 

OR 

BLANK FILL 



M 1093 



WORD 
1 



15 

16 



17 



PREFIX 









HEADER 


FWA 


DATA SEGMENT 1 




LENGTH 


OF DATA SEGMENT 


1 


DATA SEGMENT 1 


FWA 


DATA SEGMENT 2 




LENGTH 


OF DATA SEGMENT 


2 


DATA SEGMENT 2 


• 
• 
• 


FWA 


DATA SEGMENT n 




LENGTH 


OF DATA SEGMENT 


n 


DATA SEGMENT n 



Figure E-2. Optional Memory Image Record 
Prefix Format 



41 35 



23 



RECORD NAME 
{DISPLAY CODE) 





7777 8 






Figure E-3. Optional Load Module Record 
Header Format 



59 



47 46 



25 23 19 



11 7 






1 





A 





B 





C 



A = HIGH-ORDER 2 BITS OF FIRST WORD ADDRESS (FWA) 

B = MIDDLE 8 BITS OF FWA 

C = LOW-ORDER 8 BITS OF FWA M-1096 

Figure E-4. Optional Memory Image Record 
First Word Address Format 



Figure E-l. Optional Load Module Record Format 
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E-l 



59 



LENGTH 



LENGTH = NUMBER OF 16-BIT WORDS IN DATA SEGMENT 

M-1097 



23 



23 



WORD 1 



WORD 2 



-*J- 



23 



-* J- 



WORD N 



Figure E-5. Optional Memory Image Record 
Length Format 



23 


19 


11 


7 ^- 





HIGH-ORDER 
EIGHT BITS OF 
16-BIT WORD 





LOW-ORDER 
EIGHT BITS OF 
16-BIT WORD 



ONE WORD OF DATA SEGMENT 



Figure E-6. Optional Load Module Record 
Segment Format 
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RELOCATABLE OBJECT CODE FILE FORMAT 



RECORD BLOCK 

The object text input to the autolink or link utilities is the 
relocatable binary code generated by the CYBER Cross 
System translators: PASCAL compiler or macro- 
assembler. The relocatable binary is represented in 
record blocks of 960 bits of information: (i.e., sixteen 
60-bit words of sixty 16-bit words). 

The data portion of the record block is formatted 
accordingly: 

Word 1 (16-bit words) - 

Bits 15 through 8 = module sequence number 

Bits 7 through 4 = 5, the 7/9 binary card indicator 

Bits 3 through = 

Word 2 = the complement of the length of the data 
portion in 16-bit words; 

Word 3 to n = the object text block 

Word 3 + n + 1 = the checksum 

A record block will not exceed one card image, thus the 
length of an object text block (words 3 to n, where n is the 
length of the data portion, is 57 words or less. The 
checksum immediately follows the last data word in the 
record block; and if the data portion is less than 57 words, 
the record block is padded to fill a complete 80-column 
card image. 



The following is the format for the eight block types. 
Note that the word positions indicated are relative to the 
beginning of an object text block. 



NAM BLOCK 

The NAM block contains a word count for common and 
data storage, the module length, and the name of the 
program. See figure F-l. 



RBD BLOCK 

An RBD block contains a portion of the actual command 
sequence data of the module. See figure F-2. Words 2 
through 57 contain the relocation bytes and words for the 
command sequence input. Each relocation byte is a 4-bit 
indicator that identifies a word of the command sequence 
input as an absolute 15-bit address, or as a 15-bit address 
relative to some relocation base. The relocation base for 
a word is determined by the particular combination of bit 
settings within the relocation byte. 

The following are the relocation bytes in RBD blocks: 

0000 Absolute (no relocation) 

0001 Positive program relocation 
0101 Negative program relocation 

0010 Positive common storage relocation 

0110 Negative common storage relocation 

0011 Positive data storage relocation 

0111 Negative data storage relocation 



OBJECT TEXT BLOCK 

The object text block, which contains the relocatable 
binary information, is headed by a type of block indicator 
field in bits 15 through 13 of the first object text word. 
The following object text block types are defined: 



Type 


Indicator 


Description 


NAM 


001 


Name block 


RBD 


010 


Command block sequence 


BZS 


011 


Zero storage block 


ENT 


100 


Entry point block 


EXT 


101 


External name block 


ENF 


000 


Entry field block 


EXF 


111 


External field block 


XFR 


110 


Transfer address block 



The remainder of this first word contains a constant of 
bits 6 and 4 set equal 1, and all other bits set equal 0. 

A module's object text begins with a NAM block and 
terminates with an XFR block. The ENT and EXF blocks 
follow the RBD blocks. The RBD, BZS, ENT, and ENF 
blocks may come in any order. 





15 


11 




7 


3 


1 


10 





10 1 





2 


NUMBER OF WORDS IN 
COMMON STORAGE BLOCK 


3 
4 


NUMBER OF WORDS IN 
DATA STORAGE BLOCK 

PROGRAM LENGTH 


5 


CHARACTER 1 


CHARACTER 2 


6 


CHARACTER 3 


CHARACTER 4 


7 


CHARACTER 5 


CHARACTER 6 


8 













NAM STATEMENT COMMENTS 



DATA PORTION 



'PROGRAM NAME 



NOT USED 



67 



Figure F-l. NAM Block Image 
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15 


11 




7 




3 


1 


10 





10 1 





2 


R0 


R1 


R2 


R3 


3 


WO 


4 


W1 


5 


W2 


6 


W3 


7 


R4 


R5 


R6 


R7 


8 


W4 


9 


W5 


10 


W6 


11 


W7 


12 


R8 


R9 


RIO 


R11 





























52 


R40 


R41 


R42 


R43 


53 


W40 


54 


W41 


55 


W42 


56 


W43 


57 




NOT USED 







Figure F-2. RBD Block Image 



where Wn is the nth word of the input block (n = 1 to 43); 
Rn is the relocation byte of the nth word; WO is the origin 
address of the input block; and RO is the relocation byte 
for WO. 

There is one relocation byte for every word in the 
command sequence output, and a maximum of 45 entries 
in the RBD block. The first word is the address relative 
to the start of the program where the loader begins 
storing command sequence data. The relocation byte for 
the first word address (storage address) of an RBD block 
may be 0000, 0001, or 0011. If the field contains a 
number larger than 0011, 0011 is assumed. Zero is the 
leading bit for all but the last relocation byte 1 is the 
leading bit for the last relocation byte. 



BZS BLOCK 

A BZS block contains relocation bytes, the starting 
address, and block sizes for areas of core to be cleared to 
zeros when the program is loaded. See figure F-3. 

where A is the starting address; S is the size of the area 
reserved by BZS; R is the relocation of the starting 
address; An is the starting address of the nth entry; Sn is 
the size of the BZS reservation for the nth entry; and Rn 
is the relocation byte of the nth entry. 

The relocation bytes for a starting address may be 0000, 
0001, or 0011. 





15 






11 










7 




3 





1 





1 1 


















10 1 








2 


R1 


R2 


R3 


R4 


3 


A1 


4 


S1 


5 
















A2 








6 


S2 


7 


A3 


8 


S3 


9 


A4 


10 


S4 


11 


R5 


R6 


R7 


R8 
























i 















47 


R21 


R22 


R23 


R24 


48 


A21 


49 


S21 


50 


A22 


51 


S22 


52 


A23 


53 


S23 


54 


A24 


55 


S24 


56 


NOT USED 


57 


NOT USED 



Figure F-3. BZS Block Image 



ENF BLOCK 



Up to 11 entry fields may be specified in an ENF block. 
See figure F-4. The end of data in this block is identified 
by zeros. If the sign bit of a word containing the entry 
point address is 0, the address is program-relocatable. If 
the sign bit is 1, the address is absolute and in one's 
complement. Data begins in word 2. 

where name n is a six-character name of the nth entry in 
the block; and En is the entry address of the nth field 
name. En is negative (one's complement) if absolute, and 
positive if relative. FLDST n is the leftmost bit of the 
nth field: O^FLDST n £15. FLDLTH n is the length of the 
nth field: IsFLDLTH nS16. 



ENT BLOCK 

Up to 14 entry point names and addresses may be included 
in an ENT block. See figure F-5. The end of data in this 
block is identified by zeros. If the sign bit of a word 
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15 



11 



10 



11 



52 
53 

54 
55 
56 



00 





10 1 





CHARACTER 1 


CHARACTER 2 


CHARACTER 3 


CHARACTER 4 


CHARACTER 5 


CHARACTER 6 


E1 


FLDST 
1 


FLDLTH 1-1 


NOT USED 


CHARACTER 1 


CHARACTER 2 


CHARACTER 3 


CHARACTER 4 


CHARACTER 5 


CHARACTER 6 


E2 


FLDST 
2 


FLDLTH 2-1 


NOT USED 




CHARACTER 1 


CHARACTER 2 \ 


CHARACTER 3 


CHARACTER 4 1 


CHARACTER 5 


CHARACTER 6 > 


E11 l 


FLDST 
11 


FLDLTH 11-1 


NOT USED 1 



"FIELD NAME 1 



FIELD NAME 2 



>FIELD NAME 11 



Figure F-4. ENF Block Image 



containing the entry-point address is 0, the address is 
program-relocatable. If the sign bit of the word is 1, the 
address is absolute and in one's complement. Data begins 
in word 2 and extends to word 57. 

where name n is a six-character name of the nth entry in 
the block. En is the entry-point address of the nth name. 
En is negative (one's complement) if absolute, and positive 
if program-relocatable. 

When processing an ENT block, the loader records the 
entry-point name in its table. The entry-point address is 
adjusted for relocation (either program or absolute), then 
it is recorded in the table of entry points. This procedure 
is repeated until the end of input is reached (a name equal 
to 0). 



EXF BLOCK 

Up to 14 external fields and link addresses may be 
included in an EXF block. See figure F-6. 

where name n is a six-character name of the nth entry in 
the block. Ln is the link address of the nth name. Ln is 
negative (one's complement) if absolute, and positive if 
relative. 



15 11 

10 



CHARACTER 1 



CHARACTER 3 



CHARACTER 5 



10 1 



CHARACTER 2 



CHARACTER 4 



CHARACTER 6 
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CHARACTER 1 



CHARACTER 3 



CHARACTER 5 



CHARACTER 2 



CHARACTER 4 



CHARACTER 6 



E2 



NAME 1 



> NAME 2 
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CHARACTER 1 


CHARACTER 2 
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CHARACTER 3 


CHARACTER 4 
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CHARACTER 5 


CHARACTER 6 


53 


E13 


54 


CHARACTER 1 


CHARACTER 2 


55 


CHARACTER 3 


CHARACTER 4 


56 


CHARACTER 5 


CHARACTER 6 


57 


E14 



>NAME 14 



M-1103 



Figure F-5. ENT Block Image 



The end of the EXF block is indicated by zeros. If the 
sign bit of the word containing the link address is 0, the 
address is program-relocatable. If the sign bit is 1, the 
address is absolute and in one's complement. The format 
of the data in the block is the same for EXF as for ENT 
information. Relative external fields are indicated by 
setting the leftmost bit of the word containing character 
1 of the field name. An external name which contains no 
references within the modules object text is indicated by 
a $8000 in the link address. 



EXT BLOCK 

Up to 14 external names and link addresses may be 
included in an EXT block. See figure F-7. 

where name n is a six-character name of the nth entry in 
the block. Ln is the link address of the nth name. Ln is 
negative (one's complement) if absolute, and positive if 
relative. 



60471200 F 



F-3 





15 


11 




7 




3 


1 


1110 











1 1 







2 


CHARACTER 1 


CHARACTER 2 


^ 


3 


CHARACTER 3 


CHARACTER 4 




4 


CHARACTER 5 


CHARACTER 6 




5 


LI 


) 


6 


CHARACTER 1 


CHARACTER 2 


) 


7 


CHARACTER 3 


CHARACTER 4 


I 


8 


CHARACTER 5 


CHARACTER 6 


I 


9 


L2 


) 





























50 


CHARACTER 1 


CHARACTER 2 


51 


CHARACTER 3 


CHARACTER 4 


52 


CHARACTER 5 


CHARACTER 6 


53 


LI 3 


54 


CHARACTER 1 


CHARACTER 2 


55 


CHARACTER 3 


CHARACTER 4 


56 


CHARACTER 5 


CHARACTER 6 


57 


L14 



NAME 1 



NAME 2 



^NAME 13 



>NAME 14 





15 


11 




7 




3 


1 


10 10 











1 1 





2 


CHARACTER 1 


CHARACTER 2 


3 


CHARACTER 3 


CHARACTER 4 


4 


CHARACTER 5 


CHARACTER 6 


5 


L1 


6 


CHARACTER 1 


CHARACTER 2 


7 


CHARACTER 3 


CHARACTER 4 


8 


CHARACTER 5 


CHARACTER 6 


9 


L2 




■ 




• 


50 


CHARACTER 1 


CHARACTER 2 


51 


CHARACTER 3 


CHARACTER 4 


52 


CHARACTER 5 


CHARACTER 6 


53 


L13 


54 


CHARACTER 1 


CHARACTER 2 


55 


CHARACTER 3 


CHARACTER 4 


56 


CHARACTER 5 


CHARACTER 6 


57 


L14 



>NAME 1 



• NAME 2 



>NAME 13 



>NAME 14 



M-i 105 



Figure F-6. EXF Block Image 



Figure F-7. EXT Block Image 



The end of the EXT block is indicated by zeros. If the 
sign bit of the word containing the link address is 0, the 
address is program-relocatable. If the sign bit is 1, the 
address is absolute and in one's complement. The format 
of the data in the block is the same for EXT as for ENT 
information. Relative externals are indicated by setting 
the leftmost bit of the word containing character 1 of the 
name. The end-of-link is indicated by a $7FFF. 



XFR BLOCK 

The XFR block contains a transfer address (in words 2 to 
4), which is six ASCII characters in length, including 
trailing spaces. See figure F-8. The transfer address 
must be an entry point in the program being loaded, or in 
another program loaded during the same load operation. 



15 



110 





10 1 





CHARACTER 1 


CHARACTER 2 


CHARACTER 3 


CHARACTER 4 


CHARACTER 5 


CHARACTER 6 











Figure F-8. XFR Block Image 



F-A 
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AUTOLINK UTILITIES EXAMPLES 



This appendix gives examples of Airtolink files and • An informative message noting the relocation 

messages. The examples are: vectors (tophats) that were deleted during the 

space assignment of tophat modules (figure G-4) 

• A partial Autolink directives file (figure G-l) 

• An informative message giving the buffer area for 

• A list of the applications included in the build the build, both test area and user buffer areas 
* generated by the directives file of figure G-l (figure G-4) 

(figure G-2) 



An informative message noting the object 
programs in the input object code file which did 
not have an associated MOD directive (figure G-3) 
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LINKGEN INPUT DIRECTIVES LIST 



*- AUTO-LINK INPUT DI 

*- PROVIDE THE AUTO-L 

*- PRE-PROCESS THE CC 

*- DETERMINING THE OP 

* 

*SYSID,R96,CCP VARIANT 

■• 

*- PAGE DEFINITIONS, 

4- 

PAGEREG • 4 

•PAGESIZES - 8 

i» 

*- STACK RELATED DIRE 

* 

*ENT,0SIKFW,$0C40. 

♦ENT.DSTKLW.tOCFC. 

•ENT.DVARFW.SOOOO. 

♦ENT.OVARLW.iOOOO. 

*0STK,*OO40,tO9FC. 

i» 

*- MFMORY RESFRVF ARE 

*- LOCATIONS THRU 1 

RE5£SVE-i017O,*OO9F 

RESERV£»t0030,$016F 

i» 

*- 1EMORY SI2F IS StT 

*- POSSIBLE SIZES ARE 

i 

C n Ri=SIZ= » 'ib 

it 

*- SET UP SYNONY1 NA 

*SYN.VI<iAASC,VB4AASC. 

*SYN,VI4A8TA,VB4ABTA. 

i» 

THE FOLLOWING DI»E 
IN THE CCP OBJECT 
SPECIFIED IN THAT 

(1) TESTGEN - 

(2) UTOPIA - 
13) HLIP - DE 
t«l OLDSYS - 



RFCTIVES, THIS OECK AND SUPPORTING COKDECKS 
INK PROGRAM WITH INFORMATION NECESSARY TO 
P OBJECT FILE {FULL COMPILE OPTION) FOR 
TIMUM NEM3RY ALLOCATION. 

LOAD MODULE. 

<• PAGE REGISTERS, PAGESIZc IS 3K . 



CTIVES, STACK IN LOCATIONS 40 THRU FC. 



A, OVERLAY AREA IS LOCATIONS 170 THRU 09F. 
bT ALSO RESERVED FOR HISC PURPOSES. 



ACCORDING TO UPDATF *DEFINE DIRECTIVE. 
6SK, 8IK, 96K 0» 129K. 



KES FOR MSDE* TRANSLATIONS TAPLES 



*- 
*- 
*- 
*- 
*- 
*- 
*- 
*- 
*- 
*- 
*- 
♦- 

APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
r» 



NOTE- THIS SET ]F 
THE OBJECT FILE. T 
INCLUDED IN THE VA 
BY THE DIRECTIVES 



SVHODULE 

ASYNCEXT 

ASYNC 

NODE* 

HASPTIP 

HIP 

HLIP 

OLDSYS 

IWT 

CDNSOL 

BASESYS 

PIBUF2 

TUP 

INITIAL 



CTIVES SPECIFY THE AP»L ICATIONS THAT ARE 
FILE. FOUR OF THE APPLICATIONS ARE CONDITIONALLY 
THEY MAY OR MAY NOT BE IN THE OBJECT FILE. 
NONSTANDARD USEO ONLY BY CDC DEVELOPMENT. 
NONSTANDARD USEO ONLY BY CDC DEVELOPMENT. 
PENDS ON PURCHASE OF REMOTE CONCENTRATOR. 
DEPENDS OF PURCHASE OF ON-LINE DIAGNOSTICS. 

DIRECTIVES SPECIFY WHICH APPLICATIONS ARE ON 
HEY DO NOT CONTROL WHICH APPLICATIONS ARF 
RIANT BUILD. THE VARIANT BUILD IS CONTROLLED 
IN COMDECK ALOEFS. 



*- GENERATE SYNONYMS FOP THTSc APPLICATIONS THAT ARE NOT INCLUDED 
*- IN THIS VARIANT BUILD. 
* 

♦ SYN.PTHIPUPPILL. 
♦SYN.PTHTPO, PBILL. 
*SYN,P3DEBUG,PBILL. 
*SYN, UTOPIA, PBILL. 
*SYN,PBBREAKPOI.PBILL. 
*SYN,PB WRAPS NAP, PBILL. 
*SYN,PBZSNAP, PBILL. 
• 

Figure G-l. Autolink Input Directives File (Partial) 



G-2 
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THE FOLLOWING DIRECTIVES C AL L THF SUPPORTING AUTO-LINK. COMDECKS. 

(1) SETUP REPORT DEFINITIONS* 

IZi DEFINE APPLICATIONS TO INCLUDED IN THIS VARIANT BUILD. 

<3> DEFINE WHICH OBJECT MODULES BELONG TO WHICH APPLICATIONS. 

NOTE- MOO DIRECTIVES MUSI BE LAST ON AUTO-LINKtS INPUT FILE. 

COMDECK ALR»T 

THIS COMDECK SETS UP R c PORT DIRECTIVES FOR AUTO-LINK ACCORDING 
♦DEFINES < BUFSCPTjDIRECTHPT.McihaPRPT, TOPHATRPT >. 



COMDECK ALDEFS 

- IHE DIRECTIVES IN THIS COMDECK CONTROL WHICH APPLICATIONS ARc 

- TNCLUDEO IN A VARIANT RUILD. SOME APPLICATIONS ARE ALWAYS 

- INCLUDED WHILE OTHtRS ARE ONLY INCLUDED IF THEY ARE SPECIFIED 

- SV UPDATE niRFCTIVES *DFFINE. 



DEF 


= 


SVMODULE 


OtF 


= 


IVT 


DEF 


- 


3ASESYS 


OFF 


= 


INITIAL 


DEF 


= 


PISUF2 


DEF 


= 


PIPTBL 


D£F 


' 


ASYNCEXT 


DEF 


- 


mode* 


DEF 


= 


HASPTI* 


DEF 


a 


HLIP 


DEF 


= 


OLOSYS 



C«DECK ALSMOD 



THIS APPLICATION IS PAGEABLE 
N1N-PAGEA8LE (P * NP) 



IP 



PI AND 



NOO 


« PNSMWL 






(P 


■ F, 




AODR 


• $2000. 




APPL 


* SVNOOL'LE) 


HOD 


< PNAWAIT 






. <P 


• P. 




APPL 


• SVMODULE 1 


HOD 


« PNRTN 






»P 


« Pj 




APPL 


• SVMODULE) 




• 






• 






• 




* 






*- 


THE FOLLOWING 


APPLICATIONS IS LI 


*- 


PAGE. 




* 






MOO 


« PNCONFIoUKF 






IP 


- P, FILL. 




APPL 


• SVMODULE) 


MOD 


- PGOSTAT 






IP 


• P. FILL. 




TH 


- PNDSTAT. 




APPL 


= SVMOOULE/BASESYS) 


MOD 


' PNSKGEN 






(P 


- P. FILL. 




APPL 


= SVMODULE) 




• 






• 






• 




*- 
MOD 


THIS APPLICATION IS PAGEABLE. 


» PTIVTPRSR 





<P « P, FILL. 
APPL - IVT1 
NOD « PGIVTCND 

IP » P, FILL. 
TH * PTIVTCND, 
APPL ' IVT/BASESYSI 



Figure G-l. Autolink Input Directives File (Partial) (Contd) 
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G-3 



THE REST Of THIS APPLICATION IS NON-PAGE ABIE (P 
AND MUST RESIDE IN THE BASE. 

NOTE THAT PIDTBL IS A SEPERATt APPLICATION. 
THIS IS NECESSARY TO CONTROL THE LINKING. 
PIDTBL Ii THE LAST NODULE LINK?D IN THE 
FORWARD DIRECTION. 



■NP> 



NOD 



PIDTBL 



MOD * GL08LJ 



(P * NP, 
APPL ' PI0T8L) 

<P » N», 
AODR - iODAO, 
APPl => BASFSYS) 



NOD 



ZEROX 



(P 



NP, 



- THIS APPLICATION IS LINKEO IN REVERSE ORDER. 

- APPLICATION TUP IS ALWAYS INCLUDED IN A VARIANT BUILD. HOWEVER* 

- TUP IS OVERLAYED BY BUFFERS UNLESS THE VARIANT TYPE IS SPECIFIED 
AS TYPE T (TEST BUILD) IN WHICH CASE THE VARIABLE TOTUP IS SET 
TO 1. 



HOD 


X 


PSBREAKPOI 








(P 


* R, 






APPL 


* TUP) 


NOD 


* 


PBWRAPSNAP 








(P 


> 9, 






APPL 


* TUP) 


HOD 


X 


P*2SNAP 








(P 


• R, 






APPL 


• TUP) 


NOD 


* 


PB1SNAP 








(P 


» R» 






APPL 


» TUP) 




• 







*- 
♦- 
*- 

* 

MOD 



HOD 



HOD 



HOD 



THIS APPLICATION IS LINKED IN REVERSE ORDER. 

PIHLIA RESIDES IN HIGHEST CORE ANO MAINS RESIDES IN 

LOWEST CORE. 

= PIHLIA 

IP ' R» 

APPL » INITIAL) 
» PITMRS 

<P * 1, 

APPL » INITIAL) 
« PILININIT 

(P « R> 

APPL « INITIAL) 
- PIAPPS 

(P ■ R, 

APPL » INITIAL) 






i» 

#- 

*- 

*- 

*- 

*- 

i 

HOD 



COMDECK ALTJDE4 



THIS APPLICATION IS NON-PAGEABLE AND 
PAGEABLE. 



K<iHUN 



HOD * R<iH*CC 



(P = NP, FILL, 

appl * *nnm 

(P ' NP, FILL, 

APPL * H0DF4) 



HOD = R*M4TP 



(P 



* P. 






Figure G-l. Autolink Input Directives File (Partial) (Contd) 



G-4 
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«P • HP* FILL* 
APPL • X23CF1S X25CF2) 
NOD • PXPAD3 

<P « P» FILL» 
APPL • L2DFBUS/ L30EBUG) 
MOO - PX2MUX 

(P « F, 
APPL ' X25L2/ X25CF1/ X25CF2) 
MOO - PX20PS 

(P « F, 
APPL « X25L2/ X25CF1/ X25CF2) 
NOD = PX2P08T 

IP • F, 
APPL « X25L2/ X25CFI/ X25CF2) 
i» 

*- END OF ALINPDIR DECK* START OF SUPPORTING CONDECKS 
* 



A A 1 A A 'A' ft x A A A A A A A ftftftft" 



JHfcftftftftft'ft'A'ft'ftftft'ftftA* 



FOR TEST PURPOSES THE BUFFER AREA. OF THIS BUILD IS 
DECIMAL = 18338 HEXADECIMAL = $47A2 

THE USER BUFFER AREA FOR THIS BUILD IS 

DECIMAL = 28453 HEXADECIMAL = $6F25 



A" ft"ftft*ftft* A* ft ft ft A 



it ftftftftftftftA*ftftftft"ft" 



Figure G-l. Autolink Input Directives File (Partial) (Contd) 



APPLICATION 
NAME 

SYMODU 

ASYNCE 

MODE4 

HASPTI 

HIP 

HLIP 

OLDSYS 

IVT 

CONSOL 

BASEST 

PIBUF2 

TUP 

INITIA 

PIDTNL 



PAGED LENGTH 


DEC 


HEX 


7729 


$1E31 


8155 


$1FDB 


7477 


$1D35 


6402 


$1902 


1443 


$05A3 


4784 


S12B0 





SO000 





$0000 





$0000 





$0000 





$0000 





$0000 





$0000 





$0000 



MAIN 


LENGTH 


DEC 


HEX 


2229 


$08B5 


2257 


$08D1 


851 


$0353 


209 


$00D1 





$0000 


306 


$0132 


50 


$0032 


410 


$01 9A 


3991 


$0F97 


14476 


$388C 





$0000 


3605 


$0E15 


2415 


$096F 


129 


$0081 



LINKGEN COMPLETED 



Figure G-2. Applications Used in the Build from Directives File (figure G-l) 
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G-5 



*****WARNING***** NO MOD DIRECTIVE FOR THESE OBJECT PGMS: 
PTDUMP 
PTIRES 
PTIBAC 
PTISTU 
RANDOM 
PTIVTl 
PTIEJE 
PTBPAT 
PTBCOD 
PTBVT1 
PTECHO 
PTUPLI 
PBDEBU 



Figure G-3. Informative Message, Missing MOD Directives 



DELETED TOPHAT MODULE LIST 

PNDSTA 
PBHALT 
PTIVTC 

Figure G-4. Deleted Tophat List and Buffer Area Message 
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LINK UTILITY EXAMPLES H 



This appendix gives the following examples: information is not necessary since the build 

procedures automatically supply all the calling 
• Two examples of calling MPLINK independently of procedures, 

the CCP or CCI build procedures (figures H-l and 

H-2). Note that in the ordinary case, this • An MPLINK directives file (figure H-3). This file 

was • produced for CCP by Autolink using the 
Autolink directives files shown in appendix G. 
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H-l 



Compile a PASCAL source program 


and build a load module satisfying external references 


from 


an object program 


library: 












ABC,CM77000,T77,P4. 




0000 , xxxx , xxxxxxxx 


.SMITH. 






REQUEST (ABSOLMP,*PF) 




*Memory Image Load 


Module File 






ATTACH(NEWLIB ,OBJPGMLIB03 , ID 


=PT 


*New Library 








ATTACH (MPLINK , ID=SCDD) 




*MPLINK Utility 








ATTACH( PASCAL , ID=SCDD ) 




*PASCAL Compiler 








PASCAL(0,CSET=64) 




*List output and use 64 char ASCII 


- 


FRMT. 












REWIND (LGO) 




*Reset Object Code 


Input File 






MPLINK(CSET=64) 




*Call MPLINK 








CATALOG (ABSOLMP.LOADMODOl , ID 


=PT,RP=30) 


*Catalog Load Module File 






7/8/9 












. . . PASCAL source program . . . 




*A11 PASCAL Source 


Programs 






7/8/9 












MPLINK directive file 












6/7/8/9 




NOTES 








After all of the object programs 


on the object code input 


file have been 


read 


and 


linked, any remaining unsatisfied 


external references can 


be resolved using the 


library if one is 


supplied. 











Figure H-l. MPLINK Execution Example 1 



Build a load module from an object program library with editing of the load module file: 

ABC,CM77000,T77,P4. 0000,xxxx,xxxxxxxx,SCHOFIELD. 

REQUEST(ZAPMP,*PF) 

ATTACH(NEWLIB,OBJPGMLIB03, ID=PT) 

ATTACH(MPLINK , ID=SCDD ) 

ATTACH (MPEDIT , ID=SCDD ) 

MPLINK(CSET=64) 

REWIND(ABSOLMP,SYMTAB) 

MPEDIT(CSET=64) 

CATALOG ( ZAPMP , LOADMOD02 , ID=PT , RP=30 ) 

7/8/9 

*REL,NEWLIB. First MPLINK Directive 

Nest of MPLINK Directive File 

6/7/8/9 



*Absolute Memory Image Load File and Symbol Table File 



Figure H-2. MPLINK Execution Example 2 



H-2 
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CYBER 


NINI CROSS SYSTEH - 
LINK DIRECTIVES 


LINK 


EDITOR - 


1 


*SYSID,R96»CCP VARIANT LOAD MODULE. 


68 


*L»PNPSTA. 


? 


*ENT,DSTKFW»$0040. 




69 


*L#PNLN8A. 


3 


*£NT,DSTKLw, JJOFC. 




73 


*L»PNSGAT-PNCECN. 


t. 


*FNT,DVARFW»$0000. 




71 


*L#PNSTOR. 


5 


*ENT,OVARLW, $0000. 




72 


*L»PTAFOU. 


f, 


*3STK,$0040,$OOFC. 




73 


*L»PTAPET. 


7 


*SYN.«/I4AASC,VR4AASC. 




74 


*L,R4ASYI-ASYMSG. 


fi 


*SYN,VI4A3TA>\/B4ABTA. 




7* 


*L#ASYLFM. 


■y 


*SYN.PNCjNTML» PBILL. 




76 


*L»PTAPSP. 


10 


*SYKSPNTS^TR»fBIlL. 




77 


*L,AASCST. 


J I 


+SYN,PNBL0X25»P8ILL. 




78 


♦L.AAFBCD. 


12 


*SYN,PNDLX2:>»P8ILL. 




79 


*L»AACAPL. 


13 


*SYN»PN5S*CH, PBILL. 




HO 


*L. ATAPLA-AASBAP. 


14 


*SYN,PNTS1QN»PBILL. 




81 


*L»ASTOAS. 


17 


*SYN,PTHI?I»P3ILL. 




82 


*L» AEBCDA. 


In 


♦SYN.PTHIPO, PBILL. 




83 


*L,AEAPLA-ACAPLA. 


17 


*SYN»PBntf JU^tPPILL. 




84 


*L»A7T06P. 


1" 


tSYN. UTOPIA. PI I'LL. 




8? 


*L»PBLN06. 


iv 


*SYN,PB8«cAKP0I»PBTLL. 




B6 


♦L.PTCTCH-P801BL. 


20 


*SYN,PBW<APii>IAF,PBll L. 




3 7 


♦L.PTINIT. 


■>\ 


*iYN.P6?SN»P.paiLL. 




38 


*L»PT1VTC. 


1? 


*SYN,PJ1S^«p»P3ILL. 




a 9 


♦L.PPSLJ . 


23 


*SYM,>'U3PSHLT,'P81LL. 




90 


*L,PGDSTA. 


24 


♦jYN.PBTUPdP-AK, PBILL. 




91 


*L»PBMLIA. 


l-j 


*SYN,P3TU>>, PBILL. 




9? 


♦L.PGSWIT. 


?b 


*?YN,PROECCOE»PRTLL. 




93 


♦L.PBLN02-PBLN03. 


27 


*SYN,P?PC^FQ0M,P8TLL. 




9* 


♦L.PBLN08. 


?* 


♦SYN.PBTIPOBG, PBILL. 




95 


♦L.PBFILE. 


?^ 


*SYN,P80MPR£G.°8ILL. 




96 


♦L.PBLMAS-P8ST0P. 


30 


*SYN,PBTU?DUtfP,P3ILL. 




97 


♦L.PTTPIN. 


31 


♦SYN.PBReAD. PBILL. 




98 


*L.MO0MST. 


3?. 


*SrN,P8WRIT» PBILL. 




99 


*L»PBLN04-PBLN15. 


33 


♦SYN.PBIEST, PBILL. 




100 


♦L.PBMEKB-PNDEQU. 


J4 


*SYN»PBQUICK,^BILL. 




101 


*L»PBFHAH-PBTOAD. 


35 


* r >YN»PBT«£Q» P3ILL. 




10? 


*L»PNMLEH. 


3b 


*S YN.PRI OS £. PBILL. 




103 


*L,PTMSCA. 


37 


*SYM,P«0*CT. PBILL. 




104 


♦L.PBCLKI-PNBMPS. 


3? 


tSYM.PBITYS, PRILL. 




105 


♦L.PMCQIN-PMCDRV. 


3 r J 


*SYNfPtJIUT1» PRILL. 




106 


*L»PBSCLA. 


4C 


*iYN,PB0C3M, PBILL. 




107 


*L,PHtiOLP-PHTlSE. 


41 


♦ SYN-.PB0ISP.P3TLL. 




108 


*L#PTLMUX. 


4? 


* c ;YN,PETTt'INT,?BILL. 




109 


*L,PBSWLE-PBINTP. 


43 


♦ SYN,PBGtTC»PBUL. 




110 


*L»PBUPAB-PTBACK. 


44 


*SYN,PriSTARTIQ, PBILL. 




HI 


*L»PTBREA. 


45 


*SYN,PBSU<»KjG. PBILL. 




112 


*L,PTSTRT-PTSTOP. 


46 


*SYN,PB3f :1T,<MILL. 




113 


*L»PTICMD. 


47 


*SYN, PBC ON SOLF, PBILL. 




114 


*L»PBI0PO-PNLLTC. 


48 


♦ "YN.PBIFT. PBILL. 




115 


*l»PBFMAD. 


49 


*C0t<»$17FFF. 




116 


*L,ODEBUG-PBCLR . 


j0 


*SYN,PNDSTA,PGOSTA. 




117 


♦L^PBLDAD-PBILL . 


"?1 


*SYN,P3SWIT.PG?yTT. 




118 


*L»PBHALT. 


5? 


*L,?EROX .IO^OuO. 




119 


*L»PBHON -TOSTOP. 


53 


*L,PBINTP-ADDR£S»iO0100. 




120 


*L»R4«4IN-R4M4CC. 


54 


*L»GL0BL$»$OODA0. 




121 


*L,LIPSMA. 


55 


♦L.ISPQLO. 




122 


*L»PNTMKS. 


56 


♦L.PBCALL. 




123 


♦L.HASPMS. 


57 


*L»PBLNQ0-PBLN01. 




124 


*L»HSR4IP. 


58 


*L,PBAHAS. 




125 


*L,PMT8L. 


5=) 


*L »PNSMWL»* 02000 :S04, 




126 


*L#HAIN$ »S0F659. 


60 


♦L.PNAWAI-PNS18A. 




127 


*L,8EGINX. 


61 


*L*PNPVRS-PNSMTR. 




128 


♦L.PIPROT-PISIZC. 


62 


*L»PNSMDI-PNLLCN. 




129 


*L#PILMT . 


63 


*L,PNLNCN-PNLNST. 




130 


*L»PINWIN. 


64 


*L»PMTHL-PNOVLO. 




131 


*L»PILCBS-PIGETA. 


65 


*L,PNFRCE. 




132 


♦L.PIFR1 . 


66 


*L»PNOVLT. 




133 


*L#PI8UFl. 


67 


*L>PNOVL0, $04000. 




134 


*L.PINIT . 




Figure H-3. 


Sample MPLINK Directives 


File for 


a CCP Run 
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H-3 



135 


*L, 


136 


*L» 


137 


*L» 


138 


*L» 


139 


*L, 


140 


♦L» 


141 


*l » 


142 


*L» 


143 


*L» 


144 


*Lt 


145 


*L» 


146 


*L» 


147 


*L. 


143 


*L» 


149 


*L» 


150 


*L» 


151 


*L» 



,PIWUN-PIAPPS. 

,PILINI-PTTNRS. 

,PIMUA. 

,PIBUF2. 

,PTASNO»$lOOOC:1i04. 

,R4ASYT-R4A274. 

,ASYERR. 

,PTMSQU. 

,PTuELM-PTASNM. 

.PTAREC-PTAFAL. 

,PTAPBU-PTAFSC. 

,PTAPI . 

,PTMD4T»$12O0O!t04. 

,R4M4TP. 

.PTSTAC-PT4TEX. 

,PT4TCR. 

.PNSMGE. 



152 


H.PTHSOP»S14000:$04 


153 


*L,HSR4IT-FCSRCB. 


154 


*L#PTHSHU. 


155 


♦L.HSPTC8-PTTPHA. 


156 


♦L.PNCONF. 


157 


*L>PGIVTC. 


158 


*L » PIT KOP, $16000* $04 


159 


*L»PLIPTC. 


160 


*L,IC 


161 


*L,PLCBIN. 


162 


*L,PLREAO. 


163 


♦ UPLIPHL. 


164 


*1>CLEANU-PLIP . 


105 


*L>PTIVTP. 


166 


♦L.PTLINI. 


167 


♦LtPGHALT. 


163 


♦ END. 



Figure H-3. Sample MPLINK Directives File for a CCP Run (Contd) 
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EDIT UTILITY EXAMPLES 



This appendix gives the following examples: • A partial listing of the memory image load module 

file (Figure 1-2). 
■ Selected portions of an MPEDIT program with 

constant, variable, and array declarations, and a Note that the Edit utility is automatically called as a part 

single assignment section for the main CCP of the CCP and CCI build procedures, 

programs (that is, no overlay assignment 
sections). This program is given in figure 1-1. 
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CYBER MINI CROSS SYSTEM - LINK EDITOR 
EDIT STATEMENTS 



**** ******** ********************** *********** 

* * 

* COPYSISHT CONTROL DAT* CORP. 1975» * 

* 197ft. 1977. 1978. 1979, 1980 * 

* ♦ 
********************************************* 
I 

r» 
**************************♦***********++**♦** 

* * 

* CJNST4KTS * 

* * 

********************************************* 
CONST 

/iruf * i; 

/FUSF « 0; 

/u&Mt = 3??; * GENERATE MPPPU FILE 



DEFINITION/DECLARATION 
SECTION 

CONSTANT DECLARATION PART 



*********************************** 

* * 

* SYiT^M CONSTANTS ♦ 

* * 
*********************************** 
i 

A 

************************************************************************ 

**CHPf SI75** 
***♦******************«♦**♦****+*********************♦♦♦♦*♦♦♦*♦*♦****♦♦♦ 
I 

/CS16K - *3FFF ; 

/CS3?K = t7FFF ; 

/CS40K = J9FFF ; 

/CS48K * tBFFF ; 

/CS5*K = tOFFF ; 

/CS6*K = JFFFES 

/CS128K » l; 

/CS25*K - 2; 
t» 
ft**,******************************************************************* 

♦ ♦BUFFER CONTROL BLOCK INDECES^ 
***+************************♦***♦******♦******♦**********+************** 

* 

* SIZE INDEX * 



/BOSO 
/BOS1 
/BOS? 
/BOS3 



- o ; 

• i ; 

• z ; 

• 3 ; 



VAR 



/IS 

Ml; 
/I2; 
M3; 

/p; 
/J; 
/L; 

/LSAYE ; 
/K * 

/CHS1LIA ; 
/CH5CONS ; 
/CHSCOO»LER 
/ICHSUBLCR; 
/LPIQ; 
/TC3CTNS ; 
/TCB*LIA ; 

/30S32! 
/IDTBL; 



VARIABLE DEFINITION PART 



» GENERAL LOOP INDEX *■ 

i» GENERAL LOO» INDEX * 

rf GENERAL LOOP INDEX * 

* GENERAL USE VARIABLE * 
» WORK "OINTER FOR MODE* STATE PROGRAMS <■ 

* GENERAL INDEX LOOP * 
.♦WORK-POINTER FOR TIP- INPUT-STATES* 

i» SAVE WORK PTR IN TEXT °*riCR HDR STATE PROGRAM* 

*VARIABLF INDEX KOCNTRTBL * 

rf SUB PORT LCB TABLE POINTERS - MLIA I 

r» CONSOLE * 

•♦ COUPLER * 

r> INDEX - CHSU3LC3 i 



i» NETWORK DEFINITION TABLE WORK POINTER 



A ******************************* ****** 

* * 

* THE FOLLOWING IS THE SOURCE INPUT ♦ 

* FUR APPLICATION UNIQUE VARIABLES * 

* DEFINITION FOR THIS SYSTEM ♦ 

* * 
************************************** 



Figure 1-1. Partial MPEDIT Program 
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dUFLCOt/3OSO../B0S3) OF 1; 
BUF1ASKSC/SOSO.. /BOS31 OF l! 
B€CTLPK[/80S0../B0S3J OF / SIZBFCTLBK ; 
NICTCT [ NO*OO..NOOIAG ] QF 1; 
NJI-CT C NOTHLTA..NOTDIAG J OF 15; 
8FTHRESH rtOTl... BOTHHUK] OF 1; 
• 

AVTCHF CO. .41 OF IS 

********************************** 

* * 

* AiVNC arrays * 

* * 
********************************* i 



rf BUFFER THRESHOLOS 



AVKdAT C 1. .401 If 3; 
SVICBAT C1..31 OF 3S 
AVTC-3FDT CJ..01 OF 1; 
4VLC3FOT 10. .11 TF 1; 



*TCB ACTION TABLE * 

* LCB ACTION TABLE * 

rfTCB FIELD DESCRIPTOR TABLE* 

rtLCS FIFID DESCRIPTOR TABLE* 



ASYNC CJOf TABLf ADORFSS ASSAYS 

AVUCCTDFTC/ACF8CD../ACCAPU OF 1; 

AVINTA-'LE C/ACEBCD../ACC APL. / NOASYAS C . . /N0nM27411 OF 1; 

AVfJTTARLr C/ACr8CD../»CCAPL,/N?ASYASC../N0I8M27*l J OF IS 

INITIALIZATION OF 5VM-ARU1YS FOR HASP-TIP 



HSTCAATC1..4CJ OF 3; 
H5LC34T CI. .2) ;1F 3; 
HSTC3F0r CJ..O) QF 15 
HSLCflFDT CD. .01 OF Is 



.♦TC8 ACTION TABLE 
t» LCB ACTION TABLE 



*********************************************************************** I 

*«ENO APPLICATION UN I SUE ARRAY SOURCE** 
*********************************************************************** I 

!» 

**************************************** 



* 


* 


* OtFINE 


"SFIIOO VARIABLES * 


* 


* 


**************************************** 


B^GIN 




VARIO : 


- *96S 


vA»n*i 


:« tOOOFs 


CCP^E* 


:= * 32 ! 


CCPCYC 


t= OS 


CCPLEV 


:• OS 


/TRAC* 


«» 2 i 


/ESLS 


:* 2: 



ASSIGNMENT SECTION 



PSEUDO VARIABLE DECLARATION 
PART (PART OF ASSIGNMENT 
SECTION) 



i»CCP VFRSION - CSD REPLACES* 
.♦CCP CYCLE -USER REPLACES* 
*CCP LEVEL - CSO REPLACES* 

i» EXTEPNAL SYI" TBL LIST ON * 



* * 

* DEFINE AS CANY POTMFPS * 

* AS "OSSI-SLE * 

* * 
********************************************* 
* 

rf* 

/"CS32 :■ /1PSIS ♦ Is 

b=SIN» ♦ to s» HATNts .» SYSTE" INIT 

********** ****************** ********* 

* SEI UP POiT fuRIE* BtLINICE»S * 
************************************* 
* 

CENT! If s« *»D: 
CIE^U TS:« !5S 



INITIALIZE WURKLISTS FOR OP* LEVEL PROGRAMS 



* * INTFRNAL PROCESS * ♦ 

BY>JLCBt39TN«L J.BYP»AO0» J» GENTRY ( PBtXTPRQC » i 

BYMLCBnOlN.iL l.BYPAGE :■ /PGNON ( P JINTPKOCI ? 

BYkLCBCBOINWL J.BYWLINOEX «« BlINtftS 

BYKLCBtBOINWL 1..8VMAKMT »• *S 

BYWLCUSOimL l.BVINC »• 2j 

!JY»lC9t33IH«iL l.SYWLRFO :• /TRUF; 



Figure 1-1. Partial MPEDiT Program (Contd) 
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r»* I 

,»* ************ ** ******************** 

* SERVICF NODULE LOCAL VARIABLES ♦ 

************************************ 

/BZOWNE»S 

/9ZLNSPOS 

/BZN2; 

/3Z1PKTLNTH8 

/B72PKTLNTHS 

/3ZK; 

/bzilpvc; 

/BZ2LPVC8 

/BZOCE; 

/BZTRANSTYPES 

/BZ1LSVC; 

/BZ2LSVC; 

/BZLAPB; 

/BZT1; 

ZLCHS 

/BSTCLASSs 

/BSOWNER; 

/bscn; 

/ON; 

/SN; 

/bsnbl; 

/bsipri; 

/bspgwidth; 

/bspglengths 

/b5cancmar; 

/bsbschaks 

/bscntrlchar; 

/bscridless 

/3slfidlfss 

/B?CRC»LC; 
/■^StfCALC: 
/BSSPEDIT; 
/■iSXPARFNTs 

/■jsxchm: 
/BSXCHLs 
/BSXCHA*: 

/ssxros 
msindfv; 
/bsouto^vs 
/8SFCnn»Lx; 
/BSPGHAITS 
fBSPARITY; 
/BSABTLlNEs 
/3SUSR1; 
/BSUSP2; 
fBSCODES 
MSXCHR™I5 
f BSCHAfcRECS 

/LCBVABIANT! *FIRST VARIANT LCB INOEX * 

/INVARIANT; t»FIRST VARIANT TCB INDEX * 

/DQLCBCOT; 

/0OTC3F0T: 

/COS^BFSZE; 
,»* ************************************************************** *******<. 

rf*CNO APPLICATION UNTOUe VAPIABIE SOURCE** 

,,* ************************************************************** *******!, 

„ .' ARRARY DECLARATION 

****+■********♦***************♦******♦******** 

* * 

* ARRAY DECLARATION* - BASE AND CC P * 

* T43LF.S * 

* * 
********************************************* 

I 

ARRAY 

BJTIPTYPT IN0HDLC..N1USP11 OF /SIZTIPTYPTj 

BWWLENTRY tl.,17] OF /JlWLNAXS 

C4TIMTBLC COICBTNSCN . .COSPAREI OF *; 

CGTCBS C0..C4TCN1] OF /SIZTCB? FIXED TCBS . * 

JACT C/TTY../LP17421 OF /SIZCT; 

JAIQWl C/FALSE../TRUEJ OF 1; 

JGTtSTABLE t /FALSF. . /TRUE. /FALSE. ./ TRUE* /F ALSE . . /TRUE! OF 1; 

JZQPSBASE CBOCHWL..BCOUHHY] OF 2; i» DPS PROGRAM ARRAY A 

JKNASK [1..171 OF 1; 

JKTNASKU..17] OF Is 

JSHLA0OR_I0j.l71_OF Is 

JITUPBFRS CI. .64] OF 1; 

N<UTYT CNOLOIAG..NOLAST,l..NKRC30UT] OF 2; 

N>=LTP INOLDIAG. .NOLAST] HF Is 

BUFLENGTHf/B0SO../BOS3] OF I; 

TCBLENGTHt/90TSO../BOTS7] OF IS 



Figure 1-1. Partial MPEDIT Program (Contd) 
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* * MLIA INTERRUPT HANDLER * * 



SrWLCBt30MLWL J.BYPRAODR 

3YWLCBIBOMLWL l.BYPAGE 

8YWLCBlBOML<a 1.BYWLINOFX 

BYiLCBIBOMLrfL l.BYMAXCNT 

BYWLCBtBOMLWL l.BYINC 

SYULCBtBOHLVIL l.BYtlLRtQ 



s- /ENTRY<PBNLIAOPS); 

!» /PGNUM<PBMLIAOPS»; 

:* BOHLWL! 

«» 10J 

s- 5; 

:» /TRUE! 



* * 



SERVICE MODULE 



8YWLCBI80SMWL l.BYPRADDR 

8YWLCBCBOSNHL l.BYPAGE 

BYWLcaraosiiHL i.bywlinoex 

BYWLCBtSOSMrfL l.BYMAXCNT 

BYWLCBOOSM*L l.BYINC 

BYWLCHBOSMWL I.eYWLREO 



* * 



t« /ENTRY (PNSNWLt; 

s« /PGNUMCPNSMWLI; 

:« BOSMWL; 

•■' l; 

s= 4; 

s- /TRUE; 









FOR /I :» I 10 17 DO 

BEGIN 

JSnLAOOn/11 s* B»WLENTRY*/J1MLMAX*(/I-1J: 
EN!); 
THfc VALUcS IN JKTMASK ARE IHE SANE AS THOSE IN JKIliK 



FOR..TO LOOP 



JKMASktt ] 


: = 


0! 


JKTIASKtl 1 


: « 


os 


JKMASKt? 1 


: * 


1J 


4KTHASKC2 1 


: m 


l; 


JK1ASKI3 J 


i = 


5; 


JKTHASKI3 1 


: « 


5; 


JKNASKI* 1 


: = 


*0; 


JKTMASKC4 1 


: x 


*D; 


JK«ASKC5 ] 


: = 


HO: 


JKTNASKC5 J 


: * 


UD; 


JKHAS<C6 1 


X s 


t30; 


JKTHASKC6 1 


: x 


*3D; 


JK«ASKC7 J 


: = 


tlF; 


JKTNASKI7 ] 


: x 


*1F; 


JKHASKC* ] 


: = 


S1F; 


JKTMASKI3 ] 


: • 


tlFs 


JKt»«S<[9 J 


:•« 


«hf; 


JKTNASKC9 ] 


: « 


$FF 5 


JK*ASKC101 


: = 


$1FF; 


JKTMASKtlO] 


: x 


*1FF; 


JKHASKtll] 


: = 


$3FFi 


JKTMASKtll] 


: = 


J3FF; 


J*NASKC121 


: = 


J7FF; 


JKTMASKU21 


: * 


S7FF; 


JKN4SKC131 


: = 


$FFF; 


JKTMASKI131 


: = 


$FFF; 


JKMASKtl<t] 


: = 


ilFFF; 


JKTMASKtl'il 


: * 


S1FFF; 


JKKASKU5] 


; x 


«3FFF; 


JKTMASKC15] 


: > 


$3FFF; 


JKHASKI161 


: = 


*7FtF; 


JKTMASKC16] 


: m 


*7FEF; 


JK«ASKtl71 

• 
• 




tFFFF; 


JKTNASKI171 




1FFFFS 



* 
1*1 



********************************************************************** 
INITIALIZATION OF LINE TYPE TABLES * 

********************************************************************** 



NESTED FOR..TO LOOPS 



FOR /ls-MCLOIAG TD NOLAST DO 
FCR Ml := 3 TO NKRC30UT DO 
NRLTYT [/1./IU.NBINT2 s-JFFFF; 



& PRIME ALL SECOND WDS 



SET UP CLEAR AND DISABLE COMMANDS 

N1LDIAG TO NOLAST 00 



FOR /I 
BFG1N 

NBLIYTt /I.NKCLRL1.NBINT2 :* *0*00; 

NBLTYTt/I,N«DISLl.N3INT2 s« $0400; 
FNO; 



*SET THE TERMINAL BUSY BIT 4. 
i»TO BUSY OUT THE MODEM * 



*LINE TYPt (NOLOIAG) USED FOR ON LINE DIAGNOSTICS ONLY. LINE 
.♦CHARACTERISTICS ARE TAYLORED DINANICALLY DURING EXECUTION 



NBLTYT 


CN0LDIA,2 J.NBINTls.MILTO; 


i» 


MODEM STATES PTR. TABLE 


ADDR* 


NBLTYT 


CN0LDIA»NKINILl.N8INTls«»O02OS 


i» 


INIT. 


SET (ISONI 


* 


NBLTYT 


tNOLDIA,NK£NBLl.N8INTl!x»B8<iO; 


* 


ENABLE 


SET IDTR, RTS, 


ISR)» 


NBLTYT 


CN0LDIA,NKINPT].NBINTls.t020 0; 


<t 


INPUT 


SET (IONI 


+ 


NBLTYT 


tNOLDIA,NKDOUTl.NBINTls«$0100j 


# 


DIR.OUT 


SET (00N> 


»• 


NBLTYT 


tNOLDIA.NKOBT I.NBINT1 t -S8B0O; 


i» 


OBT 


SET IRTS. DTRI 


* 


NBLTYT 


CNOLDIA.NKINOUI.NBINTls-SOlOOj 


i» 


IN. AFT. 


SET IOON) AND 


I 


NBLTYT 


CN0LDIA,NKINOUJ.NBINT2s.*FDFFj 


i» 




RESETUONJ 


t 


NBLTYT 


CN0LDIA,NKENDIl.NBINT2t»$FDFF; 


* 


TERM. INP 


RESETUONl 


* 


NBLTYT 


CNGLDIA»NKEND01.NBINT2s«»FEFF; 


i» 


TERN. OUT 


RESETIOONl 


* 



Figure 1-1. Partial MPEDIT Program (Contd) 
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************** *************************** ************* ** **************** 

** SET UP BUFFER ARE* POINTERS ** 
************************************************************************ 

*** IDTBL *** 

IDTBl OFFINrS A NETWORK TO THE CCP. IT MUST BE 
IDENTICALLY INITIALIZED IN EVERY NPU OF A NETWORK. 

IOTBL CONTAINS ONE ENTRY FOR EACH NPU IN THE NETWORK. 
EACH ENTRY IS A VARIABLE NUMBER OF WOROS FOLLOWED 8Y 
J7FFF AS A TERMINATOR. THE FIN*L ENTRY IS FOLLOWED BY 
TWO CONSECUTIVE TcRMINATORS. 

THF FIRST WORD OF AN IDTBL ENTRT IS THE NODE ID OF THE 
NPU IN QUESTION. IF THE NPU IS A LOCAL ONE, EACH ID 
ACCESSED VIA COUPLFR IS CONTAINED IN FOLLOWING WORDS. 
FINALLT« THERE IS ONE WORD FOR EACH TRUNK CONNECTED 
TO THF NPU: THF LINK-REMOT^-NODE ID IS IN THF RIGHT 
HALF. AND THE P0»T NUMBER IS TN THE LEFT HALF. 



inTBLP := PIDT3L; 
/IDTBL := PIDTBL - 1; 
/L := 0; 



.» PASCAL IDTBL POINTER. 
■> EDITING IDTBL POINTER. 



/L 


: = 


/I 


*■ 


1 


/IDTBL 


+ 


/L 


X 


10016; 


/L 


: = 


It 


+ 


1 


/IDTBL 


+ 


/L 


; - 


$0208: 


/L 


X 


/L 


t 


1 


/IIUBL 


♦ 


/I 


i 


1030C; 


/L 


X 


It 


+ 


1 


/IDTBL 


+ 


/L 


; = 


$0400; 


/I 


= 


/L 


t 


1 


/IDTBL 


+ 


/L 


3 


/ENDF; 


/L 


= 


/L 


+■ 


1 


/IDTBL 


♦ 


/L 


X 


tOOOB; 


/L 


X 


/L 


*■ 


1 


/IDTBL 


♦ 


/I 


* = 


$0000; 


/L 


= 


/L 


<• 


1 


/imBL 


♦ 


/L 


: = 


$0001; 


/L 


X 


/L 


+ 


1 


/IDTBL 


+ 


/L 


. 


«0C03; 


/L 


X 


IX. 


+ 


1 


/IDT3L 


4 


/L 


X 


/FNDF; 


/L 


- 


/L 


♦ 


1 


./IDTBL 


+ 


/L 


X 


SOJOC; 


/L 


* 


/L 


* 


1 


/IDTBL 


+ 


/L 


I 


«0000: 


/L 


X 


/L 


♦ 


1 


/IDT31 


+ 


/L 


■ 


$0001; 


/L 


X 


/L 


♦ 


1 


/IOTBL 


♦ 


/I 


X 


$0004; 


/L 


= 


/L 


+ 


1 


/IOTBL 


+ 


/L 


X 


/ENDE; 


/L 


X 


/I 


+ 


1 


/IDTBL 


♦ 


/L • 


X 


$0000; 


/L 


X 


/L 


♦ 


1 


/IDTBL 


♦ 


n 


X 


$0000; 


/L 


= 


11 


♦ 


1 


/IDTBL 


♦ 


/L ! 


« 


$0001; 


n 


X 


11 


«• 


1 


/IOTBL 


♦ 


/L 


X 


$0005; 


/L 


X 


/L 


+ 


1 


/IDTBL 


+ 


/L : 


« 


/ENDE; 


/L 


M 


/L 


+ 


1 


/IDTBL 


+ 


/L i 


• 


/ENDE; 



B3SBUF :« /L ♦ /IDTBL ♦ 1; iHMCREHENT AVAILABLE CORE PTR 






,►*************** + **********+************************** 

* ♦ 

* SET UP BASF TCB FIELD DESCRIPTOR TAB1F * 

* * 
******************************************** *********( 



DOTCBFDT := DGTCPFDT; 

DGTC3FPTC0].nDNUMFNT ! 

/aSTCl ASS 

0GTC3FDTC 5].DDFSTRT 

PGfBFOTC !?].DDFLNTH 

DGTCBFDTt 5KD0FDISP 



••0; 



5; 



*N0. OF ENTRIES 



- /STARTIBSTCLASS); 
* /LFNGTH(BSTCLASS); 
= BSTCL&SS; 



/B>OwNER 

OGTCiFDTtl'l.nDFSTRT 
!T;TC3F!UI:12].DDELNTH 
nr,TCBFDTtl21.DDFDISP 



i« 12; 

:« /STARTIBSOWNER); 
:= /L5NGTH(BS3WNER); 
:= "SHWNFR; 



/BSCN 

DGTC^FIjTCm.ODcSTPT 

D-;TCBFnTC13].DDFLNTH 



:« 13; 
:= /STARIIRSCN); 
/LENSTrtlBSCN); 



nGTC3F0Ttl3].DDFDISP := 3SCN; 

Figure 1-1. Partial MPEDIT Program (Contd) 
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*l 



/ON ■' l*. 

0C.TC8FOTU43.DOFSTRT := »F; 

DGTCBFDTC143.DDFLNTH :- T, 

0GTCUF0Ttl<i].DDF0I5P :» BSLLCBi 

/SN 5« 15; 

DSTCBFQTtlSl.DDFSTRT :> 7J 

DGTC8FnT[15].DDFLNTH ' ' T, 

DGTCdFDTC15].DDFDIS» :» 9SLIC8: 

/BSIPRI " 19; 

DGTCSFDTtl'Jl.OOFSTRT «* /START (BSIPR I ) 5 

DGTCBFDTC191.0DFLNTH s* /LENGTH! BS IPRI ) J 

DGTCBFDTI191.DDF0ISP :* BSIPRI; 



CBTIMTBLtCOHLIPl.CBINTVAL :* Z; 
A ^^^t************************ *********************************** ******** 
**END APPLICATION UNIQUE EXECUTION STATF1ENT SOURCE** _ AosifWMPMT <5FrTir>N 

FNO. 



Figure 1-1. Partial MPEDIT Program (Contd) 
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CY8ER HINI CROSS SYSTEM - UNK EDITOR - 
ItNORY IMAGE FILE OUHP 

***t **»5 ***6 ***t ***e **** ***h ***a 



***C ***0 **»E ***F 



HEADER 




































0000 


t: 






01*2 


5 239 


3620 


2C20 


4343 


5020 


5641 


5249 


414E 


5420 


4C4F 


414* 


2040 


4F44 


0010 




554C 


4520 


2020 


2020 


2020 


20 »0 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


202O»l 




R91b 




































HtAOER 




































0000 


f : 


:0040 


40eo 




5A45 


524F 


5820 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2C20 


2020 


0010 




2C20 


2f>2C 


2020 


2 020 


2020 


2020 


2020 


2020 


2020 


2020 


2C20 


205» 


4557 


4F20: 


1 




Z c *9x 




































3000 


t i 


: 1*00 


F*,71 






























<>010 




































0020 




































0030 


































: J 


HtAOER 




































ooco 


t ! 


:0PCF 


401E 


^7i 


4?4 5 


4749 


4S53 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


0010 




2o2J 


2020 


2«2C 


2 020 


2020 


2020 


2^20 


2020 


2020 


2020 


2C20 


2042 


4547 


494ES 


1 




B^GINX 




































F670 




t 


:0401 


COOO 


10<=C 


0402 


CCOO 




0433 


cooa 


0040 


34C4 


COO 




1400 


F659»l 


HFADFR 




































0000 


t 


:0040 


4000 


0100 


5042 


4946 


5452 


4E54 


4552 


5255 


5054 


2054 


5241 


5053 


2054 


4142 


4C45 


3010 




2C2* 


4C4F 


4144 


2041 


5420 


2431 


3030 


292C 


?020 


2021 


2C20 


2049 


4E54 


5241: 


1 




PBTNT" 




































0130 


c 




140C 


1F9B 






1400 


1FC4 






1400 


52C9 
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